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1. INTRODUCTION 


Use of this manual presupposes a familiarity with the instruction repertoire and instruction 
and data formats of the UNIVAC 9200/9300. 


1.1. THE PURPOSE OF AN ASSEMBLER 


An Assembler is one result of the many and continuing efforts to improve communica- 
tions between computers and computer users. The general direction of these efforts 
has been towards an intermediate language which is close to the language of the user 
and which relies heavily on the computer for translation into its language. 


In an Assembler language all coding is represented in the form of statements which 
are understandable to the programmer. The Assembler then converts these statements 
into a binary form which is understandable to the computer. The programmer’s state- 
ments, when keypunched, are called source code. The Assembler converts the source 
code into object code. Figure 1~1 shows the general flow of source-to-object code 
conversion with an Assembler. 


PROGRAMMER 


states the problem in the 
Language of the Assembler 


SOURCE CODE 


statements kevnunched in 
card code form 


ASSEMBLY 


translation to Object Code 


OBJECT CODE 





Binary Expressions 
meaningful to the computer 
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Figure 1-1. Source-to-Object Code Translation with Assembler 
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CARD ASSEMBLER FOR THE UNIVAC 9200/9300 


The Card Assembler for the UNIVAC 9200/9300 System is an efficient, easy-to-use 
software aid that satisfactorily handles most of the programming problems encountered 
by the user. Each machine instruction and data form have simple, convenient repre- 
sentations in the assembly language. The rules which govern the use of the language 
are not complex; they may be learned quickly and applied easily. 


A program in Card Assembler language for the 9200/9300 is written on a standard 
UNIVAC coding form. The information on the form is keypunched, and the resulting 
source deck is read twice by the Assembler. Output cards, or an object deck, are 
produced by the Assembler in relocatable object code or absolute object code. The 
object deck is ready for loading into the UNIVAC 9200/9300 by means of the Card 
Program Loader routine. The basic flow of the 9200/9300 Card Assembler and asso- 
ciated software is shown in Figure 1—2. Input to the Assembler is a card deck key- 
punched from an Assembler coding form or is the output from the Preassembly Macro 
Pass. 


The macro library is in macro code. Parameters are established for the macros by means 
of macro instructions. The Preassembly Macro Pass (described in Appendix A of this 
manual) converts the macro code into source code in preparation for assembly. 


The assembly operation is a conventional two-pass procedure which produces a card 
deck in relocatable object code. The outputs of several separate assemblies may be 
combined by means of a Linker. The Linker output is in absolute object code. When a 
program is ready to be run, the relocatable or absolute object deck is loaded by a Card 
Program Loader subroutine. 
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Figure 1-2. 9200/9300 Assembly System 
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ASSEMBLY LANGUAGE CHARACTERISTICS 


The succeeding sections of this manual describe in detail the use of the Assembler 
coding form and the operational characteristics of the Assembler. These characteristics 
are summarized briefly as follows: 


Mnemonic Operation Codes — A fixed name, consisting of two, three, or four letters, is 
assigned to each machine instruction. The name is chosen to suggest the nature 
of the instruction, thereby helping the user to learn and remember the instruction. 


Symbolic Addressing and Automatic Storage Assignment — Symbolic labels may be 
assigned to instructions or groups of data. An instruction may then reference 
the labeled data by label rather than by storage address. In many cases, other 
data required by the instruction (such as operand length) may be supplied auto- 
matically by the Assembler. Another major task of the Assembler is to keep 
track of all storage locations used and to assign all incoming instructions and 
data to specific locations. The Assembler also handles all base register and 
displacement calculations. 


Flexible Data Representation — Data may be represented in the Assembler in decimal, 
hexadecimal, or character notation, thus allowing the programmer to choose the 
most suitable form for each constant. 


Relocatable Programs and Program Linking — Programs are prepared by the Assembler 
in an absolute or relocatable form. In relocatable form, the actual storage loca- 
tions to be occupied by a program need not be specified at assembly time, or if 
specified, they may easily be altered before loading. Provisions are made for 
linking together, loading, and running as one program the results of separate 
assemblies, thereby reducing the machine time required to make changes to one 
part of a program. 


Program Listing — One of the outputs of the Assembler is a printed listing of source 
and object codes. This listing includes flags marking any errors detected by the 
Assembler. Source code errors do not cause the Assembler to stall. The Assembler 
continues to process the rest of the source code performing its usual error checks, 
thus minimizing the number of assemblies required to produce error-free code. 
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2. THE ASSEMBLER LANGUAGE 


CHARACTER SET 


The character set used in writing statements in the Assembler language consists of: 


Letters Az B, ©) asayZ 
Digits 0, 4,.2344339 
Special Symbols * +-,()' blank 


STATEMENT FORMAT 


Statements in the Assembler language are written on a standard coding form. Informa- 
tion for the Assembler and comments are written in columns 1 through 71. Column 72 
must be blank. Columns 73 through 80 may contain program identification and sequenc- 
ing information. The information in columns 1 through 71 consists of the following 
fields. 


Label Field 


The label field begins in column 1 and is terminated by a blank column. There may 
be no embedded blanks. It may either be a blank field or contain a symbol whose 
value is to be defined. More detailed information about symbols is contained under 
headings 2.3.6. and 3.1.1. 


Operation Field 


The operation field begins with the first nonblank following the label field and is 
terminated by a blank. It contains either the name of an assembler directive or the 
mnemonic operation code for a machine instruction. 


Operand Field 


The operand field begins with the first nonblank following the operation field and 
is terminated by a blank not contained in a character representation. This field con- 
tains information which defines the operands of a machine instruction or which 
supplies the specifications required with an assembler directive. 
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2.2.4. Comments Field 


263: 


ree 


The comments field begins with the column following the blank terminating the 
operand field and ends at column 71. It may contain any combination of characters 
including blanks. It is not processed by the Assembler other than including it on 
the assembly listing. It may contain remarks to clarify the purpose or operation of 
the associated coding. A line may consist entirely of comments from columns 2 
through 71 if column 1 contains an asterisk. 
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Figures 2-1. Example of Source Code Statements 


Although the assembler language is free form, it is recommended that source code 
statements be written with the first character of the operation code in column 8 
and the first character of the operand field in column 14. Tabulating the statements 
in this fashion creates a program listing which is neater in appearance and easier 
to read. The standard coding form is ruled to conform to this convention. Thus, 
although the statements on lines 3 and 4 of Figure 2—1 are equivalent to the 
Assembler, the form of line 4 is preferred to that of line 3. 


EXPRESSIONS 


pt 


bler language ox 
one or more expressions. Expressions are grouped by parentheses and separated by 
commas. For example, the basic operand formats for computer instructions are shown 
in Table 2—3. In this table, each subscripted letter represents an expression. An ex- 
pression may be a single term or a number of terms connected by operators. The 
permissible operators are a plus sign (+) representing addition and a minus sign (—) 
representing subtraction. A leading minus sign is also allowed to produce the nega- 
tive of the first term. All operations are performed in two’s-complement binary nota- 
tion. A term may be one of the following: 


A decimal, hexadecimal, or character representation of an actual value. 


A location counter reference. 


A symbol. 


Decimal Representation 


A value may be represented directly by a string of up to five digits, 0 through 9, 
forming a decimal number from 0 through 32767. Such a number is converted to a 
binary value occupying one or two bytes depending on the type of field for which it 
is intended. Following are some decimal representations. 


UNIVAC 9200/9300 


UP-4092 CARD ASSEMBLER SECTION: PAGE: 








Decimal Representation Binary Value 
0 00000000 
13 00001101 
257 00060001 00000001 
32767 OLITTIV. Littaris 


2.3.2. Hexadecimal Representation 


A hexadecimal representation consists of a string of digits preceded by X' and 
followed by ' (apostrophe). Each hexadecimal digit represents a half byte of in- 
formation. The hexadecimal digits and their values are: 


0 — 0000 8 — 1000 
1 — 0001 9 —-— 1001 
2 — 0010 A — 1010 
3 — 0011 B - 1011 
4 — 0100 C — 1100 
5 — 0101" D — 1101 
6 —- 0110 E — 1110 
7 — 0111 F — 1111 


Some examples of hexadecimal representations and their values are: 





Hexadecimal Representation Binary Value 
X'D! 00001101 
X'101' 00000001 00000061 
X'7FFF'! 01111111 11111111 


2.3.3. Character Representation 


A character representation consists of a string of characters preceded by C' and 
followed by '. The following are valid character representations. 






Character Representatio EBCDIC Value 


C'D' 11000100 
C'GROSS' 100011111011001110101101110001011100010 
C*9! 11111001 


2.3.4. Location Counter 


An indication of the next storage location available for assignment is maintained as 
a counter called the location counter. After the Assembler processes an instruction 
or constant, it adds the length of the instruction or constant processed to the loca- 
tion counter. 
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Each instruction or address constant must have an address which is a multiple of 
two. Such an address is said to fall on a halfword boundary. If the value of the lo- 
cation counter is not a multiple of two when assembling such a constant or an in- 
struction, a one is added to the location counter before assigning an address to the 


current line. Storage locations reserved by this process receive binary zeros when 
the program is loaded. 


The current value of the location counter is available for reference in the Assembler 
language and is represented by the single special character * (asterisk). If written 
in a constant representation or in an instruction operand expression, this symbol is 
replaced by the storage address of the leftmost byte allocated to that instruction or 
constant. Thus the instruction 


BC 1537 


represents a one-instruction loop. 


Relative Addressing 


An instruction may address data in its immediate vicinity in storage in terms of its 
own storage address. This is called relative addressing and is achieved by an ex- 
pression of the form *+n or *-n where n is the difference in storage addresses of 
the referring instruction and the instruction or constant being accessed. Relative 
addressing is always in terms of bytes, not words or instructions. For example, in 
the coding 


LABEL 6 OPERATIONS OPERAND 6 
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the address *+12 in the second line is the address of the instruction in the last 
line and the address *-12 in the fourth line is the address of the instruction in the 
first line since each of the first four instructions is four bytes long. 


Symbols 


A symbol is a group of up to four alphanumeric characters. The first, or leftmost, 
must be alphabetic. Special characters or blanks may not be contained within a 
symbol. The following are examples of valid symbols: 


A LOSS 
A72Z PRET 
CAT 
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The following are not valid symbols for the reasons stated: 


GROSS More than four characters 
NPA Embedded blank 
SR)N Special character 


A symbol may be assigned any value from 0 through 32767. It is assigned a value, 
or defined, when it appears in the label field of any source code statement other 
than a comment. A symbol appearing in the label fieid of an EQU or ORG directive 
is assigned the value of the expression in the operand field. In all other cases the 
value assigned is the current value of the location counter after adjustment to a 
halfword boundary, if necessary. The value is assigned to the current label before 
the location counter is incremented for the next instruction, constant, or storage 
definition. Thus, if a symbol appears in the label field of a statement defining an 
instruction, constant, or storage area, the symbol is assigned a value equal to the 
storage area address of that instruction, constant, or storage area. 


Relocatable and Absolute Expressions 


A single term may be either relocatable or absolute. Decimal, character, and hexa- 
decimal representations are all absolute terms. A location counter reference within 
a section of relocatable code yields a relocatable value. If a symbol is defined by 
appearing in the label field of a source code statement within a section of relocat- 
able code, its value will be relocatable. 


An expression is relocatable in the following cases: if it consists of an absolute 
expression plus a relocatable term; if it can be reordered to have that form; or if it 
consists solely of a relocatable term. Some examples of relocatable expressions are: 


where R represents a relocatable term and A an absolute term. 


An expression is absolute if all of the terms in the expression are absolute or if it 
consists only of absolute terms plus an even number of relocatable terms of which 
exactly half are preceded by minus signs. Some examples of absolute expressions 
are: 


At+tA-—A 
A-—A+A+A 
R+A—R 
R-R+A 
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An expression may be negatively relocatable under certain circumstances (see Data 
Constants, heading 2.5.1). Such an expression consists of an absolute expression 
minus a relocatable expression, or an expression which may be reordered to that 


form. Some examples are as follows: 
A—R A—R-—R+R R-—R+A—-R 


Length Attribute 


The Assembler associates a length attribute with a symbol defined in the label field 
of a source code line representing an instruction, constant, or storage definition. 

The length attribute of such a symbol is the number of bytes assigned to the instruc- 
tion, constant, or storage area involved. The length attribute of an expression is also 
determined by the Assembler and is a function of the leading term of the expression. 
If the first term of an expression is an absolute value, a length attribute of one byte 
is assigned to the expression. If the leading term is a symbol, the number of bytes 
attributed to the expression is the same as the length attributed to the symbol. Thus, 
if TAG appears in the label field of an LH instruction (Load Halfword), it would have 
a length attribute of 4 since LH is a 4-byte instruction. In referencing the same label, 
the expression TAG + 195 also has a length attribute of 4; but the expression 195 + 
TAG has a length attribute of 1 because the leading term is a constant. 


MACHINE INSTRUCTIONS 


A list of the standard machine instructions giving the numeric and hexadecimal opera- 
tion codes with the instruction type is shown in Table 2-1. 


The machine instruction format consists of a label (optional), a mnemonic operation 
code, and an operand. If a symbol is used in the label field of a machine instruction, 

it is assigned the address of the leftmost character of the instruction and receives 

a length attribute equal to the length of that instruction. There are four tynes of in- 
struction formats. These are shown below together with a brief explanation of the func- 
tions performed by the instructions within each format type. Table 2—2 defines the sym- 
bols used in the instruction type formats. 


HEXADECIMAL 
MNEMONIC FUNCTION OPERATION FORMAT 
CODE 


ADD HALFWORD 


ADD IMMEDIATE 


ADD (PACKED) DECIMAL 


BRANCH AND LINK 


BRANCH ON CONDITION 


COMPARE HALFWORD 


COMPARE LOGICAL CHARACTER 


COMPARE LOGICAL IMMEDIATE 


Table 2—1. Instruction Mnemonics 
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| | | HEXADECIMAL | | 






MNEMONIC FUNCTION OPERATION FORMAT 


CODE 











COMPARE (PACKED) DECIMAL 


















DP DIVIDE (PACKED) DECIMAL 
ED EDIT 
HPR HALT AND PROCEED AQ SI | 
LH LOAD HALFWORD 48 RX 
LPSC LOAD PROGRAM STATE CONTROL | A8 S| 
MP MULTIPLY (PACKED) DECIMAL FC $$2 
MVC MOVE CHARACTERS D2 SS1 
MVI | MOVE IMMEDIATE DATA | 92 | si | 
MVN | MOVE NUMERICS | D1 ! S$1 | 
MVO MOVE WITH OFFSET | Fl $$2 
NC AND CHARACTERS | D4 ssl 
NI | AND IMMEDIATE DATA | 94 | si | 
oc OR CHARACTERS D6 SS1 | 
Ol | OR IMMEDIATE DATA 96 S| | 
PACK PACK F2 $$2 
SH SUBTRACT HALFWORD AB RX 

| SP | SUBTRACT (PACKED) DECIMAL | FB $$2 
SPSC | STORE PROGRAM STATE CONTROL AO S| 

SRC | SUPERVISOR REQUEST Al SI 
STH | STORE HALFWORD 40 RX 

| TiO | TEST 1/0 | AS S| 
T™ | TEST UNDER MASK 91 S| 
TR | TRANSLATE Dc $$1 

| UNPK | UNPACK | F3 | ss2 | 
XIOF | EXECUTE INPUT/OUTPUT FUNCTION | A4 


ZERO ADD (PACKED) DECIMAL 


Table 2—1. Instruction Mnemonics (cont.) 
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SYMBOL MEANING 


The number of the register addressed as operand 1 


The immediate data or device address used as operand 2 
of an SI instruction. 


The length of the operands * 


The length of operand i * 
The storage address of operand i 
The base register for operand i 


The displacement for operand i 





* This is the true length of the operand, not the length less one, as required in object code. The 
Assembler makes the necessary reduction of one in the length when converting source to object code. 


Table 2—2. Symbols Used In Describing Operand Formats 


2.4.1. RX — Register to Storage Instructions 


REGISTER aoe BASE REG. DISPLACEMENT 


OP CODE RX 
Ry D2 


0 7 8 $i 42 15 16 19 20 31 
Complete Operands Form: R y,D9(,B9) 4-byte instruction 





In general, instructions in this format are used to process data between registers 
and storage, and include such functions as load, store, compare, add, subtract and 
branch. The mnemonic codes for instructions using this type of format are: 


AH Add Halfword 

BAL Branch and Link 

BC Branch on Condition 
CH Compare Halfword 
LH Load Halfword 

SH Subtract Halfword 
STH Store Halfword 


2.4.2. SI — Instruction to Storage Instructions 


IMMEDIATE OPERAND BASE REG. DISPLACEMENT 


OP CODE S| 
eo. Dy 
0 7 8 15 16 19 20 31 





Compiete Operands Form: D1 (Byz),I9 4-byte instruction 
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In general, instructions with this format are used for processing with control data 


contained in the instruction. The mnemonic codes for instructions using this type 
of format are: 


Al Add Immediate 

CLI Compare Logical Immediate 
HPR Halt and Proceed 

LPSC Load Program State Control 
MVI Move Immediate Data 

NI AND Immediate Data 

Ol OR Immediate Data 

SPSC Store Program State Control 
SRC Supervisor Request 

TIO Test I/O 

™ Test Under Mask 

XIOF Execute I/O Function 


2.4.3. SS1 — Storage to Storage Instructions 


0 bs 1S. 216 19 20 31 


} BASE oe DISPLACEMENT : 
Ro Dd. 
2 


Bo D 
32 35-35 47 


Complete Operands Form: D,(L,B,),D9(Bo) 6-byte instruction 


The instructions with this format are used to process data in storage where the 
operands are of equal length, and include such functions as comparing, transferring, 
translating, and logical operations. The mnemonic codes for instructions using this 
type of format are: 


CLC Compare Logical Character 
ED Edit 

MVC Move Characters 

MVN Move Numerics 

NC AND Characters 

OC OR Characters 


TR Translate 
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2.4.4. SS2 — Storage to Storage Instructions 





DISPLACEMENT 





OP CODE $$2 
Dy 
0 7 8 15 16 19 20 31 
DISPLACEMENT -* 
Do 
32 35 36 47 
Complete Operands Form: D,(L,,B,),D9(Lo,Bo) 6-byte instruction 


The instructions with this format are used to process operands of unequal length 


and to process packed decimal values. The various functions include decimal opera- 
tions (add, subtract, compare), shift operations, and pack and unpack operations. 


The mnemonic codes for instructions using this type of format are: 


AP 
CP 

DP 
MP 
MVO 
PACK 
SP 

UN PK 
ZAP 


Add Packed Decimal 
Compare Packed Decimal 
Divide Packed Decimal 
Multiply Packed Decimal 
Move With Offset 

Pack 

Subtract Packed Decimal 
Unpack 

Zero Add Packed Decimal 


Where an operand is described in terms of a storage address and a length, the ex- 


pression used may be simplified from that shown in the instruction format by imply- 
ing the base register and the length. Information supplied in the USING and DROP 
directives enable the Assembler to separate a storage address into a base register 
and a displacement. If a length attribute is associated with the expression but is 

not specified in the statement, a value equal to the length of the operand is supplied 
by the Assembler. Table 2—3 lists the complete specification for the operand referenc- 
ing memory, applicable instruction types, and the operand format as it may be 


written utilizing an implicit base register and/or length representations. 
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OPERAND SPECIFICATION USING 
APPLICABLE 
SPECIFICATION IMPLIED BASE IMPLIED BASE 


COMPLETE 





ptlatiee, FOR ONE REGISTER IMPLIED REGISTER 
OPERAND NOTATION LENGTH AND LENGTH 


Table 2—3. Operand Specifications Using Implied Base Register And Length Notation 


Example: To move 80 characters from the field labeled OPA defined as a 90-char- 
acter field to the field labeled OPB and defined as an 80-character field, 
the instruction could be written as 


MVC OPB,OPA 


If 90 characters were to be moved the instruction would be written 


MVC OPB(90),OPA 


2.5. DATA AND STORAGE FORMATS 


The formats for data and storage statements are similar to that for a machine instruc- 
tion. A symbol may be used in the label field. It is assigned the address of the left- 
most character of the constant or storage area being specified and is attributed with 
a length equal to that of the specified constant or storage area. The operation code 
is either DC (Define Constant) or DS (Define Storage). The operand has various 
formats which are explained below. 
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2.5.1. DC — Define Constant 


There are three types of constants: C for character representation; X for hexadecimal; 


and Y for expression. To define a constant, the assembly directive DC is written in 
the operation field. The statement has the form: 






OPERATION CODE OPERAND 


or 







OPERATION CODE OPERAND 


Y(e) 





or 









OPERATION CODE OPERAND 


Symbol 


where: n is a decimal number < 16 specifying the number of bytes the constant 
is to occupy. 


t is X or C denoting hexadecimal or character representation, respec- 
tively, 


c is the actual character or hexadecimal representation for the constant, 
and 


e is any acceptable expression as previously defined. 


2.5.1.1. Character Representation 


A character representation is a string of as many as 16 characters, including 
blanks, enclosed by apostrophe marks. The apostrophe mark itself is represented 
by two successive apostrophes and an ampersand by two successive ampersands. 
In each of these cases the 2 characters count only as one towards the limit of 16. 
Thus, to represent a character constant of 16 apostrophies, 32 successive apos- 
trophies would be written, preceded by and ended with an apostrophe. The length 
specification may be omitted, in which case the length of the constant is deter- 
mined implicitly from the number of characters between the apostrophe marks. If 
the number of characters in apostrophes is greater than the length n, the rightmost 
characters are truncated to fit the field in the area reserved for it. If the number 
of characters between apostrophes is less than the length, the value is padded 
with blanks on the right to fill the field. 


For example, the following lines each result in a two-byte constant consisting of 
the letter A followed by blank. The third representation is flagged with an error 
indication. 
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LABEL % OPERATIONS OPERAND 6 
8 14 























Hexadecimal Representation 


A hexadecimal representation is a string of as many as 32 hexadecimal digits en- 
closed by apostrophe marks. If the digit string is less than twice the length speci- 
fication, the field is padded with hexadecima! zeros on the left. If more than twice 
the length specification, the representation is truncated on the left to produce a 
value equal to the length. The length specification may be omitted, in which case 
the length of the constant is determined as the smallest number of bytes which 
will contain the constant specified. If necessary, the field is padded on the left 
with one hexadecimal zero. 


The following illustrates the values of source statements which represent valid 
hexadecimal constants, three bytes in length: 





CONSTANT REPRESENTATION VALUE 
DC XL3'I1' 00000000 00000000 00000001 
DC X'123A5' 00000001 00100011 10100101 
DC X'1F3456' 00011111 00110100 01010110 


Expression Constants 


Constants of type Y provide a way to write a constant involving a relocatable 


necifiration T.1 1¢ nat nracant tha avnracainn dofinineag 
Pw tseue Hess iva aw 224M vr BV wwiist 3 asin VvaApivevuvivil Mw dda ske 


expression. If the length s 
an expression constant may have any value from — 32,768 to 32,767 inclusive and 
may be absolute, relocatable, or negatively relocatable. (A negatively relocatable 
expression consists of an absolute expression minus a relocatable expression, 

or an expression that can be reordered to that form.) This type of expression con- 
stant (one in which the length specification L1 is not present) provides a con- 

venient notation for representing a complete storage address. It is for this reason 


that constants of this type are called address constants. 


An address constant always occupies two bytes of storage and location counter 
adjustment to a halfword boundary is performed by the Assembler before storage 
locations are assigned to the constant. No such adjustment is performed for 
hexadecimal or character constants. 


For example, an address constant designed to generate the address assigned to 
the label ‘TAG’ would take the following form. 


DC Y(TAG) 
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An expression constant in which the length specification L1 is present may have 
any value from 0 through 255 and may be absolute, relocatable, or negatively re- 
locatable. It always occupies one byte of storage, and no location counter adjust- 
ment is made before assigning a memory location to the constant. It is useful when 
an externally defined symbol is assigned to only one byte. 


A summary of constant types, lengths, padding and truncation rules appears in 


Table 2—4. 
CONSTANT EXPLICIT IMPLICIT TRUNCATION 
TYPE LENGTH LENGTH OR PADDING 


variable maximum on right side 


1~16 16 


variable maximum on left side 


1-16 16 


not on left side 
stated 


on left side 





Table 2—4. Characteristics Of The Various Constants 


2.5.2. Define Storage 


The format of the assembler language statement to reserve storage is: 


LABEL | OPERATION CODE 










Symbol (Optional) 





or 









OPERATION CODE OPERAND 


Symbol (Optional) 


where: d is a non-negative integer called the duplication factor, the number of 
fields to be reserved (d may be a maximum of 256), 


n is a decimal number representing the length of the field to be reserved 
(n may be a maximum of 256), 


H represents a field whose length is two bytes and whose storage 
address must be on a halfword boundary. 


The statement DS 0H causes the location counter to be adjusted to a multiple of 
two without reserving storage. A duplication factor of zero may be used with any 
storage definition statement to define the address and length of a field without re- 
serving storage for it. The duplication factor may be omitted, in which case a factor 
of one is assumed. 
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Thus: 
CARD DS OCL80 
FRST DS CL40 
LAST DS CL40 


would define an 80-byte field named CARD, a 40-byte field named FRST whose 
address is the same as that of CARD, and a field named LAST whose length is 40 
bytes and whose address is 40 greater than that of CARD and FRST. 


The location counter is not increased in assembling CARD (because duplication 
factor is 0) but is with FRST and LAST. Therefore, 40 + 40 = 80 spaces are reserved, 
with FIRST and CARD assigned the starting location and LAST assigned the mid 
point. When the duplication factor is specified, it defines the number of fields of 
length n (for C) or the number of pairs of bytes (for H) to be reserved. For example, 


TAG DS 13H 


reserves 13 pairs of bytes. The symbol, TAG, refers to the first pair of bytes only 
and not to the entire 26 bytes. TAG would have a length attribute of two in this 
instance, 
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3. ASSEMBLER DIRECTIVES 
AND SYSTEM CODES 


cle DIRECTIVES 


In addition to the representation of machine instructions, constants, and storage, 

the assembler language includes several assembler directives. These are instructions 
to the Assembler to perform certain functions and provide the user of the assembler 
language with control of the operation of the Assembler. 


The assembler directives, grouped by function, are as follows: 


Symbol Definition 
EQU 
Assembler Control 


START 


END 


sla 


ORG 


Base Register Assignment 
USING 
DROP 
Program Linking 
ENTRY 
EXTRN 


Assembler directives, except START, may use a symbol in the operand field, and, 


with the exception of ENTRY and EXTRN, the symbol must have appeared in the 
label field of a previous statement. 


3.1.1. Symbol Definition 
EQU —- Equate 


The value and length attribute of a symbol may 


to accomplish this has the form 








OPERATION OPERAND 


where: e, and e, are expressions. 
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The symbol is defined to have a length attribute equal to the value of the second 
expression in the operand. The second expression in the operand may be omitted, 
in which case the symbol is defined to have the length attribute of the first ex- 


pression. 


The symbol in the label field is defined to have the value of the first expression in 
the operand field. If the value of the first expression in the operand field is not 
between 0 and 32767, the statement will be flagged with an error indication and the 
symbol will remain undefined. 


Thus, if the value of the location counter is 2000 when the following lines are 
encountered, 


LABEL 6 OPERATIONS OPERAND 6B 
4 


1 8 1 
TAG 11 IDS 1. | 1256410 ioe Aiton a 
HLDE , | [EQu , | |1,00+,74 _1,5,0 ade eh foi A Np ostie fe genld 


SB6K 1 | [equ | [nAGHa7O—oe tii ti | 








TAG has a relocatable value of 2000 and a length attribute of 10. 
HIDE has a relocatable value of 2100 and a length attribute of 150. 
SEEK has an absolute value of 20, and a length attribute of 10. 


Assembly Control 


Assembler directives are available to control the program name and initial location, 
alter the location counter in a specified manner, and indicate the end of the program 
statement and the instruction with which execution of the object program is to begin. 


START — Program Start 


The START directive defines the program name and tentative starting location. 
It must precede all other program statements except comments. The format of the 
START directive is 







LABEL OPERATION OPERAND 


Decimal or Hexadecimal representation 


The expression in the operand field is evaluated and incremented if necessary to 
make it a multiple of four. The result becomes the initial setting of the location 
counter and is the value of the symbol in the label field. This symbol becomes 

the Program IDentification (PID) and is available as an entry point without being 
separately defined as such (refer to Program Linking, heading 3.1.4.). Although the 
operand of the START directive is an absolute value, it is treated as relocatable. 
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Thus the value of the location counter and the coding which follows a START 
directive are both relocatable. Any one of the statements below would result in 
the program having the name SORT, being assigned to locations starting at 1068, 
and having the symbol SORT defined with the relocatable value 1068. 


SORT START 1065 
SORT START 1068 
SORT START X'42C' 


A START directive preceded by one or more statements other than comments is 
ignored and flagged as an error. A START directive whose operand field does not 
have a value from 0 to 32764 is ignored and flagged as an error. If there is no 
valid START directive, the program name is left blank and the location counter 
is set to 0. 


END — Program End 


The END directive indicates to the Assembler the end of the program being 
assembled. The format of the END directive is 






OPERATION OPERAND 





Symbol (optional) Expression (optional) 


With an END directive the Assembler stops reading cards, punches any remaining 
data which has accumulated, and then punches a Transfer Card. If the operand 
field of the END directive contains an expression, this expression is punched 
into the Transfer Card to signify to the load routine the address at which to begin 
program execution. If there is no expression in the operand field of the END 
directive, the corresponding field of the Transfer Card is blank. In that case when 
the load routine encounters the Transfer Card, it transfers control to the first 


location loaded. 


If a symbol appears in the label field of the END directive, it is assigned the 
current value of the location counter. This is normally one greater than the high- 
est address assigned to the program being assembled. 


ORG —- Set Location Counter 


The ORG directive is used to set the location counter to a specified value. The 
format of the ORG directive is 






LABEL OPERATION OPERAND 





Symbol (optional) A single expression 
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The location counter is set to the value of the expression in the operand field. 


If a symbol appears in the label field, its value is also the value of the expression 
in the operand field and is assigned a length attribute of one. The expression in 


the operand field must be either an absolute expression with a value between 0 
and 32767 or a relocatable expression with a value between the initial location 
counter setting and 32768. If the expression does not have a value within this 
range, the ORG directive is ignored and the line is flagged with an error indica- 
tion. With the ORG directive it is possible to set the location counter to a value 
which is not a halfword boundary. 


The ORG directive to set the location counter to a value 603 less than its current 
setting would be 








LABEL OPERATION OPERAND 


The ORG directive may be used to reserve a number of locations which are not 
expressed as a single decimal integer. For example, to reserve A minus B bytes 
of storage where A and B are previously defined symbols, the statement is written 





OPERATION OPERAND 


Bytes of storage reserved either with a DS or ORG directive are not set to zero 
when the program is loaded. 


If the operand of an ORG directive is a relocatable expression, the value to which 
the location counter is set and the coding that follows the ORG directive are both 


relocatable. If the operand is an absolute expression, the value to which the loca- 
tion counter is set and the coding that follows the ORG directive are both absolute. 


Base Register Assignment 


The Assembler assumes the responsibility for converting storage addresses to base 
register and displacement values for insertion into instructions being assembled. 
To do this the Assembler must be informed of the available registers and the values 
assumed to be in those registers. The assembly directives USING and DROP are 


available for this purpose. 


Silvaoks 


USING — Assign Base Register 


The USING directive informs the Assembler that a specified register is available 
for base register assignment and that it contains a specified value. The format 
of the USING directive is 









OPERAND 





LABEL OPERATION 





Symbol (optional) 


where: R is a relocatable expression and A is an absolute expression. 
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The first expression represents the value the Assembler assumes is in the speci- 


fied register at object time. The second expression in the operand field must be 
a number from 8 through 15 which denotes the general register specified. 


DROP — Unassign Base Register 


The format of the DROP directive is 


LABEL | OPERATION | OPERAND 


Symbol (optional) DROP Absolute expression 


This directive informs the Assembler that the specified base register no longer 
contains a value available to the Assembler for computing base register and dis- 
placement values. The expression in the operand field of the DROP directive is 

a number from 8 through 15 which denotes the general register no longer available. 


The Assembler maintains a table of the available registers and the values they 
contain at object time. This table is referred to as the USING table. A USING 
directive adds a register and value to the USING table or revises the value for a 
register already in the table. A DROP directive removes a register and its asso- 
ciated value from the table. If the operands of a USING or DROP directive are not 
valid, the directive is ignored, and the line is flagged with an error indication. 


If an operand address is given as a relative address instead of as a base register 
and displacement specification, the Assembler searches the USING table for a 
value yielding a valid displacement, that is, a displacement of 4095 or less. If 
there is more than one such value, that value which yields the smallest displace- 
ment is chosen. If no value yields a valid displacement, the operand address is 


set to zero and the line is flagged with an error indication. If more than one reg- 


An absolute address with no base register indicated is treated as an absolute, 
direct address. 


The placement of a USING directive determines the instructions whose operand 
addresses may be decomposed based on that USING statement. The first operand 
of the USING statement determines the portion of the program which may be 
addressed using the specified register. Thus, if a program contains the coding 


LABEL OPERATION OPERAND 





USING C,10 


B DC Y(C) 
C DS CL10 
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the B2 and D2 fields of the instruction labeled A will contain 10 and 0, respec- 
tively. Moreover, if the program contains no USING directives for register 10 other 
than the ones shown, then the second line labeled A is the only line in the pro- 
gram for which the Assembler would consider 10 as a register available for address- 
ing the line labeled B. 


The load routine stores in register 13 the starting address of the program just 
loaded. All other registers must be loaded by the program itself in a manner con- 
sistent with the information given to the Assembler in the USING directives. The 
following example shows how this is done. 


LABEL t OPERATION 6 OPERAND 6 
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Lines two and three of the above example exemplify the following general rule: 


An LH instruction to load a value into a general register must precede 
the USING directive which informs the Assembler the value is available. 


It is also possible to specify an absolute value for the first expression in the 
operand of a USING directive. The entry in the USING table made in response to 
such a USING directive is not used to decompose relative addresses. It is used 
instead to decompose absolute addresses. For example, given the following coding 


USING 4000,15 
A LH 14,4096 


B2 and D2 fields of the instruction labeled A will contain 15 and 96 respectively. 
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Direct Addressing 


The machine instruction format provides for either base register and displacement 
addressing (indexed addressing) or direct addressing. Instructions using direct 
addressing have a faster execution time. To facilitate error checking by the 
Assembler, direct addressing is described to the Assembler in terms of the 
pseudo base registers 0, 1, 2, 3, 4, 5, 6, and 7 which contain the values 0, 4096, 
8192, 12288, 16384, 20480, 24576 and 28672, respectively. Thus, the direct 
address 512 would be treated by the Assembler as an address consisting of a 
reference to the pseudo base register 0 and a displacement of 512. The address 
4098 would yield a base of 1 and a displacement of 2. The additional forms of the 
USING directive which are available for direct addressing are, specifically 


LABEL OPERATION OPERAND 





USING an 
The first line above makes direct addressing available for addresses in the range 
0 to 4095. The second makes direct addressing available for addresses in the 
range 4096 to 8191, and so on. The DROP directive may also refer to the pseudo 
registers 0 through 7 to terminate direct addressing. 


A program involving direct addressing may still be relocatable. 


The asterisk (*) when used in the operand of the USING or DROP directive has 
a unique meaning and does not have the normal connotation of the current value 
of the location counter. 


Program Linking 


The Assembler provides, as part of its output, information which ailows the results 
of separate assemblies to be linked together, loaded, and then executed as a single 
program. Proper sectioning reduces the machine time required to make changes to an 
existing program. If a change is required, only that part which is changed need be re- 
assembled. Tke output is then linked with the remaining parts to produce the altered 
program. Proper sectioning of a program also reduces the number of symbols required 
in each of the separate assemblies. 


A symboi defined in the iabel field of element A and addressed in eiement B is said 
to be externally defined in element A and referenced in element B. Thus, by using 
the ENTRY and EXTRN directives, proper linkage is supplied when the separate 
elements are assembled. This information is handed on to the Linker program by the 
External Definition Cards and the External Reference Card which are outputs of the 


Assembler. 






3.1.4.1. 


3.1.4.2. 
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ENTRY — Externally Defined Symbol Declaration 


That portion of a program submitted as input to a single assembly is called an 
element. Each element must declare the symbols defined within that element and 
to which reference is made by other elements. Each symbol is referred to as being 
externally defined and is declared by the ENTRY directive. The ENTRY directive 
has the format 












LABEL OPERATION OPERAND 


The symbol in the operand field is declared to be externally defined. Its name and 
assigned value are included in the output of the Assembler as an External Defini- 
tion Card. 


EXTRN — Externally Referenced Symbol Declaration 


The Assembler must also be informed of all symbols referred to in the element 
being assembled but which are defined in some other element. A reference to 
such a symbol is called an external reference, and such symbols are declared in 
the EXTRN directive. The format of the EXTRN directive is 





OPERATION 






OPERAND 


The symbol in the operand field is declared to be a symbol defined in some other 
element. A symbolic name and the External Symbol Indentification assigned by 
the Assembler are included as input of the Linker as an Extemal Reference 


Card. 


3.1.5. Assembler Program Listing 


Figure 3-1 is a comprehensive example of coding in 9200/9300 Assembler language. 


The listing shown is a reproduction of an actual printout from the prototype 9200/ 


9300 System. The coding example is of a self-loading memory dump routine with a 132- 


position printer and a 63-character print bar. The memory dump routine is described 


in the ‘“‘UNIVAC 9200/9300 Programmer’s Utility Manual,’’ UP-4120. 


c60¢-dn 


ooul * THIS MEMORY DUMP ROUTINE IS ADJUSTED TO THE MD 1019 

ouu2 * MACHINE CONFIGURATION. MD 1020 

vous * MDSLF POS=132,CH=63 MD 1030 

ouu4 * THE FOLLOWING CODING IS EQUIVALENT TO THE SOURCE CODE MD 1040 

00U5 * WHICH Ig GENERATED BY THE ABOVE MACRO INSTRUCTION, MD 105N 

00U6 * PARAMETER EXPLANATION MD 1060 

y0U7 * PAR.1 POS = 969120/0K 132 FOR PRINTER CHe POSITION. MD 1070 

o0u8 * PAR«2 CH = 64 OR 48 FOR AN ASSOCIATED PRINT BAR. MD 108N Qc 
goug * PARe3 BGN = BLANK OR 128 THROUGH 32767 FOR THE MD 1090 = 
0010 * LOCATION AT WHICH MEMORY DUMP IS TO BFGIN. MO 1100 Up 
v0.1 * PAR«4 END = BLANK OR 128 THROUGH 32767 FOR THE MD 1119 ~ oO 
0012 * LOCATION AT WHICH MEMORY DUMP IS TO ENN. MD 1120 as S 
0013 * PAR«5 MEM = BKe12Kr16K+AND 32K» IF THE ENTIRE MEMORY MD 1130 = S 
0014 * 1S TO BE DUMPED AND THE ROUTINE IS TO BE MO 1149 rm 3 
0015 * LOADED INTO THE HIGHEST MEMORY LOCATIONS, MD 1159 ie 
0016 * OTHERWISE BLANK. MD 1169 

0017 * PAR.6 LOAD = 260 THROUGH 32190 FOR THE LOCATION MD 1170 

0018 * AT WHICH MEMORY ODUMP IS TO BE LOADED, MD 1180 

pug * BLANK IF MEM PARAMETER EXISTS. MD 1190 

ovzu * PAR.7 ROR = BLANK OR 1001 FOR AN ASSOCIATED READER, MD 1200 

vozi MD START 0 MD. 2010 

yo2e USING #90 MD 2011 

0023 OO0A ORG 10 MD 2012 

9024 000A noo0o00U00DNUONUNNIL pe XL10%AC+ LOADER SECTION 1ST CARD N MD 2020 

vo2s 0014 0000G0U0U000UU000 oc XLB'O? MD 2030 

0026 Q01C N20100400042 MVC = 702 666 SET BASE ADDR FOR 2ND CARD P MD 2040 

0027 vo22 92500045 MVI 69+80 CONe1 SET 80 TO D.C, AREA P MD 2059 

0028 0026 A4010002 XIOF 291 READ CARD P MD 2060 

0029 002A 47700036 RC 7962 IS XIOF ACCEPTED? DY MD 2070 

0050 002E A501 0000 TIO. 001 TEST 1/0 STATUS P MD 2080 m 
0051 0032 4720002 BC 2946 IS READER WORKING? DN MD 2090 : 
0052 0036 91000000 ™ O»x*Co? TEST STATUS BITS Pp MD a2too z 
0053 003A 47800F7U BC 83952 IS THERE ANY ERROR? NY MD 2149 

0054 QO3E A90021CU HPR = X*#21C0',0 READER OFF NORMAL RESTART H MD atan 

0035 0042 NF66 ne ¥ (3942) ADDRESS FOR 2ND CARD MD 2139 


Figure 3~1. Example of Printer Output of a Program 
(Sheet 1 of 5) 
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vose vO4H NODAND4S DC — XL4 "OADO4BE DEVICE CONTROL FOR 1ST CARD MD 214 

0097 vF70 ORG 3952 LOADER SECTION 2ND CARD N MD. a2i5n 

y038 OF 70 O50COFAF CLI #4634X"0Ct IS THIS A TYPE Y CARD? DN MD 216Nn 

0039 OF74 47800F AU BC Be k+4y IF Y CARD GO TO CONe4 C MD 217N 

vo4u OF 78 950A0F AF CLI #4559X*0At IS THIS A TYPE @ CARD? DY MD ata80 

vo4. OF7C 47800F 84 BC Re*+B Cc MO 2199 

042 UF8N 47FU0FI6 BC 1be#4+22 IF NO GO TO CONS ¢ MD 2200 

04s oF a4 n20u0F 9 nFBU MVC e413 (1) OG SET LENGTH FOR LOAD MD 3010 AG 
044 UFBA N2010F9Z0FB2 MVC -##B(2) 0440 SET ADDRESS FOR LOAD MD 3020 ie 
0045 OF90 N20U0FACOFBS MVC -#428(1) #440 LOAD TEXT P MD 3030 ox 
v046 UF96 N20100460NFAA MVC -7U(2)6#420 CON.S SET BASE ADDRESS =P MD 3040 mo 
u04T OF9C 47FU002z RC 15434 GO TO CONeA (1ST CARD) B MO 3050 ms 
v048 OFAN 0201 0F ABNFBC MVC #482) 2x$2A8 CON¢4 SET START ADDRESS P MD 306N =° 
049 UFAG 47FO0D0U BC 1590 GO TO MEMORY DUMP B MO 3079 mo 
yoou OFAA OF AE DC -YC##4) ADDRESS FOR SUBSEQUENT CARD MO 3080 ae 
yoda vDBC ORG «496 MEMORY DUMP SECTION N MD 3090 

gabe uNBC NoOU MBGN DC (0) CONST, FOR REGINNING ADNRESS MD 3100 

ods OOBE FFF MEND DC (4095) CONST. FOR ENDING ADDRESS MD 3119 

yoos voco nose MPLO) DCC (128) CONSTANT 12 MD 3120 

gods voce neu DC Y(MPPW+6) STARTING ADORESS FOR EDIT MD 3139 

006 vpc4 nFCO nc Y(M?PPW+70) ENDING ADDRFSS FOR EDIT MD 314A 

00D7 0DC6 OFFS DC 8 Y(MPPW+132=10) MD 3159 

goss 0DC8 4OSCFOFIF2F SF4FSF6 M?TR DC —XL9*4OSCFUFIF2F3F4F5F6" | TRANSLATION TABLE FOR MO 316n 

0us9 ODD1 F7FEFICICZC3CUCSCE DC  —-XLO"F7FEFOCICZC3CHCSCO’ =—«63_CH_BAR MD 3179 

00e0 VODA 9208005u MENT MVI ROrxtO8s MeDeENTRY SET LINE ADV BIT P MD 318N 

Q0e1 UNDE 92000F6C MVE = MPCN+200 MD 3190 

0062 OVE2 N20Z0F ELOF EC MVC - MPCN43(3) »MPCN42 SET VC BieCleF1eAND KI P MO 3200 

0063 VUES 4BEUOFEC LH 14 eMPCN42 SET REG 14 TO ZERO P MD 4010 

004 ODEC N2010FeA0DC4 MVC - MPCN(2) »M?CO+4 SET LIMIT OF EDIT TO 4 GR, P MD 4oan 

0005 vOF2 44030003 MPA = XIOF 193 ISSUE PRINT ORDER 63 CH BAR P MD 403n m 
0066 UNF6 47800E1U BC Br MPBO IS ORDER ACCEPTED? ON MD 4o4n : 
0007 OOFA A5030F7u TIO MPCN+O03 TEST 1/0 STATUS P MD uosn z 
0008 UOFE 472000F2 BC 2p MPA IS PRINTER WORKING? DN MD 4060 

0009 VEO2 N2000E0KOF7U MPE = MVC. 49.0.1.) # MPCN46 SET STATUS RITS FOR DISPLAY P MD 4079 = 
o07u 0E08 A90u2300 HPR -X#2300'0 PRINTER OFF NORMAL H MD 4oan 
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OT 


c60b-dN 


vo7a VEOC “7FUOLFe AC 159MPA GO TO A FOR RECOVERY B MD 4090 

vo7e VE10 9501 0F6C MPBN «CLI MPCN42 9 IS VC BO SET TO Ba? ON MD 4200 

vors VEL4 478U0EBA BC Be MPB2 IF YES GO TO B2 Cc MD afin 

vo74 VE18 92EL0F7A MVI -MPPWeX'EE? B1 N MD tan 

0075 GELC N2820F7B0F7A MVC - MPPW41(432=)) »MPPW CLEAR STANDBY P.RUFFER AREA P MD 443n 

0076 vE22 95010F6U CLI -MPCN+301 Co Is VC CM SET TO Ca? DN MD 4140 

yO77 0E26 47BU0EC2 BC ByM2C2 IF YES GO TO C2 Cc MD 42so 

0078 OE2A 95020F6U CLI MPCN4302 IS VC CN SET To C3? DN MD 416n Ac 
0079 OE2ZE 478U0ECA BC Be MPC3 IF YES GO TO C3 C MD 437n = 
voso 0E32 ueFu0DC2Z MPCY LH 159M?CO42 SET STARTING ADDR OF EDIT P MD 41an Us 
p08. 0E36 F34zZ0F7A0N3C UNPK MPPW(5),60(3) EDIT ADDRESS P MD 4190 rae 
0082 OE3C 92EEOF7E MVI - MPPW4+4eX EES MO 4200 wt S 
vous OE40 F3E7FUOUEQUU MPU —sUNPK 00 (1515) 00(8924) EDIT DATA 7 BYTES P MD 5010 =o 
p084 OE46 F11UFUOEEQU7 MVO —-: 14 (2915) + 7¢1014) EDIT DATA 8TH BYTE P MD 5oan - 32 
0085 OE4C A6FUFDOE ol 14(15) ex9F OF MD 503N A= 
v08e VESO 96FUFUOF o1 15(15)ex1FOF MD 504 

0087 0ES4 N2010F7ZE006 MVC - MPCN4+8 (2) 6(14) STORE PREDECESSOR BYTES Pp MD 5050 

0088 OESA A612003E Al 62918 R15 + 18 TO R15 P MD s060 

0089 OESE A60K003C Al 6098 R14 + 8 TO R14 P MD 5070 

0090 0E62 471GOEAL BC 19M?H IF R14 OVERFLOW GO TO H DN MD S080 

gov. 0E66 49ELODBe CH 14 >MEND IS R14 EQUAL TO MEM LIMIT? DN MD 509N 

0092 VEGA 4U7200EAE BC 2 e MPH IF YES GO TO H ¢ MD 5100 

0093 OE6E SOFUOF6A CH 15 eM2CN IS R15 EQUAL TO EDIT LIMIT? DY MD. 5440 

0094 OE72 474uU0E4U BC 42D IF NO GO TO D C MD Sian 

gos 0E76 49EUOUCU CH 14 eM?C0 IS R14 EQUAL TO 128? DN MD 5130 

0096 OE7A 47BU0EBC BC Br *+18 IF YES GO TO SS C MD S14n 

097 VE7TE M2050F74NF 72 MVC - MPCN+10(6) eM2CN4+R EXTEND PREDECESSOR BYTES P MD 58150 

yoys OF84 92U00F6E MVI -MPCN+490 SET vc FO TO Fi P MOD 516n 

0099 VE88 “7FUOF 12 BC 159MPL 60 TOL B MD 5170 

o1U0 VEBC 92010F6L MVI- MPCN4+301 SS SET VC Co TO C2 P MD §18N rn 
0101 VE90 N2010F6ANLCe MVC - MPCN(2) »MPCO+6 SET LIMIT OF EDIT P MD §19N 4 
o1u2 VE96 4BEVODBL LH 14 9MBGN SET BEGINNING ADDR TO R14 P MD Se20n Z 
olus VE9A 94F0003L NI 619X'FO8 AND ERASE 4 LSB ¢ MD 601n 

o1u4 VEIE 49EuNDCU CH 14 9M?CO IS BG.AD. SMALLER THAN 128? DY MD 6020 

o1ud OEA2 4U7AUNF 12 BC 10 eMPL IF NO GO TOL ¢ MD 603n 


Figure 3—1. Example of Printer Output of a Program (con’t.) 
(Sheet 3 of 5) 





O16 
U1lu7 
Vlus 
0109 
0110 
g1l1 
ville 
0113 
0114 
Q115 
Ulio 
u117 
u118 
0119 
012U 
ule 
0122 
0123 
0124 
0125 
Ul26 
v1l27 
0128 
6129 
0150 
g1sl 
ulse 
0155 
v154 
G135 
U136 
G157 
0158 
u1359 
0140 


VEAG 
OEAA 


OEAE 
VEB2 
OEB6 
UEBA 
OEBE 
OEC2 
VEC6 
VECA 
OECE 
OED2 
VEDS 
OEOC 
VEEO 
0EES 
0EE8 
OEEC 
OEFO 
OFF4 
OEF8 
UEFC 
OF O00 
UFO 
OF O08 
OF OC 
UF 12 
OF 18 
OF IC 
OF20 
OF 24 
OF 28 
oFeCc 
OF30 
OF 34 


4BELODCYU 
47FU0F 12 


92c1NF6C 
9201 0F6F 
“7FOOFLe2 
S2000F6C 
U7FOOFLS 
Q2020F 6b 
Y7FUNE32 
4¥gD0003C 
4BFO0DCe 


N50 700000F 72 


4760NE32 
A612003t 
A6U8003A 
47100E32 
49D00DBE 
W72U0E32 
4OFOOF6A 
47400ED2 
4BEUVOO3A 
95010F 6: 
47800ECE 
9201 0F6E 
Q2EF OF 86 


N2690F 920F B80 
NCB830F7A0CDA 


ASOS0F7U 
Hu7200F 16 
G1IF90F7U 
47800F 30 
9201 0F6C 
47FOOEO0E 
9501 0F6F 
8 7800F4A 


LH 
BC 


M?hi MVI 
MVI 
BC 
M?b?2 MVI 
BC 
M?G2 MVI 
BC 
M?C3 LH 
LH 
CLC 
BC 
Al 
Al 
BC 
CH 
BC 
CH 
RC 
LH 
CLI 
BC 
MVI 
MVI 
MVC 
MPL TR 
TIO 
BC 
™ 
BC 
MVI 
BC 
M?KO CLI 
BC 


14+M2CO 
15°M?2L 
MPCN4+2 0°41 
MPCN45¢1 
1SeoMPL 
MPCN+2°0 
LoeMPL+6 
MPCN+3 92 
159M?C1 

13°60 
15eM2CO+2 
0(8013) »MPCN+8 
6eM?PC1 

62918 

5898 

1 eM?PCL 
13*MENU 
2eM2cih 
15°M2CN 
4eMPC3+8 
14958 
MPCN+494 
BeM2C3+y 
MOCN+4ey 
MPPWH+14)XtF FE 


MPPW+24 (132-226) »MPPW+6 


MPPW(132) oMPTB-238 
MPCN+603 

PeMPL+6 
MPCN+O?X et Fat 
B»eM?PKO 

MPCN+201 

15 9MPE 

MPCNt+504 

89%*+22 


SET BEGINNING ADDR TO 128 
GO TOL 

SET vce RO TO Re 

SET ve KO TO Ke 

GO TOL 

SET vC RO TO Ri 

GO TO TT 

SET vc CO TO C3 

GO TO C1 


LOAD R13 FROM Ri 

PP SET STeADDRESS OF ENIT 
cele) TS DATA EQUAL TO PRED? 
IF NO GO TO Ci 

R15 + 18 TO R15 

Ri3Z +8 TO R13 

IF R13 OVERFLOW GO TO C1 

IS P13 EQUAL TO MEM LIMIT? 
IF YES GO TO Ci 

TS R15 EQUAL TO EDIT LIMIT? 
IF NO GO TO @@ 

LOAD R14 FROM R13 

FO IS VC FO SET TO F2? 

IF YES GO TO PP 

Fi SET VC FO TO F2 

FILt * INTO STANDBY 

PRINT BUFFER AREA 

TRANSLATE 


‘TT TEST 170 STATUS 


IS PRINTER WORKING? 
IS THFRE ANY ERROR? 
IF NO GO TO VC KO 
SET vce BO TO Be 

GO TOE 

IS vC KO SET TO Ka? 
IF YES GO TO Ke 
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DM 


MD 
MOD 


MD 
MD 
MD 
MD 
MD 
MD 
MD 
MO 
MD 
MD 
MD 
MD 
MO 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MD 
MOD 
MD 
MD 
MD 
MD 


604n 
6050N 


60609 
6070 
6089 
6N9N 
41090 
A119 
612n 
6139 
614n 
6159 
6169 
6179N 
6189 
6199 
6200 
7019 
702" 
7030 
7040 
7050 
706" 
7070 
708n 
7090 
7100 
7110 
7129 
7130 
7149 
7isn 
7169 
7170 
716n 






260¢-dn 


Ya TEWASSV GeV 


*NOILOAS 


‘aOoVG 








00€6/0026 IVAINN 


cL 


c60¢-dn 


0141 UF38 95020F6F CLI MPCN45 02 IS VC KO SET TO K3? DN MO 7190 
142 UF3C 47800F52 BC = Re MPKS IF YES GO TO K3 c MD 7200 
0145 OF4O N28300800F7A MPK4 MVC 128(132) »M?PW LOAD DATA INTO PRINT BUFFER P MD 8019 
0144 OF46 47FUODF2 BC 150¢MPA GO TO A B MD a0an 
0145 OF4A 92020F6F MVI = - MPCN#5 02 K2 SET VC KO TO K3 P MO 86030 
0146 OFYE 47FOOF4U BC 15eM?K1 GO TO Ki B MD 8040 
u147 UF52 923C005u MPK3 MVI BU eX*3C8 SET LINE ADV BITS FOR HeP, P MD 8050 ee 
0148 OF56 A4030003 XIOF 393 AND PAPER FEED TO HeP. POS C MD 806) > Zz 
0149 OFSA ASO3S0F7U TIO MPCNtO°3 TS PRINTER WORKING? DN MD 8079 ox 
0150 UFSE 47200F5A BC 29 eo IF YES REPEAT TIO c MD 808n >or- 
151 OF62 A90U2FFF HPR = -X*2FFF 40 SUCCESSFUL STOP H MD s8o0gn ~ 0 
0152 OF66 47FOOUDA BC 15eMENT RETURN TO MENT B MD ALON pi = 
0153 OF6A M?CN OS CLI16 WS FOR VC AND PREDEC,. BYTES MD 8110 Se 
0154 OF7A MPPW OS = CL132 STANDBY PRINT BUFFER ARFA MD 6120 mo 
0155 00000A0UNDDA END MENT MD 8130 ae 


SNOILIAS 
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3.1.6. Assembler Control Card 


Sadi 


On the first pass, the source code deck may be preceded by a control card which 
has the following form: 








LABEL OPERATION OPERAND 





where ABS indicates the output element is to be in absolute code form, p is a 
decimal number representing the largest address available on the computer on which 
the assembly is being done, and q is a decimal number representing the largest 
address available on the computer for which the element is being assembled. Any 
field in the operand may be omitted. If ABS is omitted, the output element is in re- 
locatable code form. If p is omitted, the memory size of the computer on which the 
element is being assembled is assumed to be 16,384. If q is omitted, the memory 
size of the computer for which the element is being assembled is assumed equal to 
the memory size of the computer on which the assembly is being done. The CTL 
card may be omitted, in which case the result is the same as indicated for each 
field omitted. 


SYSTEM CODES 


Table 3—1 shows the relation the Assembler assumes between card code, internal 
computer code, and printer graphic. The Assembler reads a source code card in com- 
pressed form and then translates it to the internal code via the translation table shown 
in Table 3—1. If keypunch equipment is used which sets up a different relationship 
between card code and printer graphic than the one shown in Table 3-1, a different 
translation table may be substituted at linker time for use by the Assembler in trans- 
lating source code cards. This translation table may set up any relation between card 
code and printer graphic that is desired; however, the relation between internal code 
and printer graphic shown in Table 3—1 must remain inviolate, since this is the only way 
the Assembler can ‘‘read’’ the source code. The Assembler prints its listing directly 
from the internal code. This operation, in effect, assumes a 63-character print bar. 

If a 48-character print bar is used while assembling, the Assembler may be modified 
at linker time to translate printer output from internal code to 48-character print bar 
code before printing. 


The Assembler punches all output cards in a compressed ‘‘object code’’ form which 
may be handled directly by the Linker or the absolute loader. 


Some users may provide programs via the Assembler to be used to process data rep- 
resented in an internal code different from the one used by the Assembler. In such a 
case, the user must take special care in the representation of his constants. For 
example, the Assembler assigns the internal code 11000001 to the graphic ‘‘A’’. If, 
at the time an object program is run, the internal code for the data assigns the code 
11000000 to the graphic ‘‘A’’, a test for equality against a constant represented as 
C'A' in source code language may not be performed as desired. 


In general, when data to be processed by an object program is represented in an in- 
ternal code other than that used by the Assembler, all difficulties can be avoided 
by representing all constants in the source code in hexadecimal. 
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0010 


0011 


0100 


0101 


© 
be 
oy 
Lm] 


| 

| 

| 

| 

| 

| 0111 

| 1000 
1001 
1010 

| 1011 
1100 

1101 

| 


1110 









TWO MOST SIGNIFICANT BITS OF ZONE — 00 


12-0-9-8-1 


12-9-1 


12-9-2 


12-9-3 


12-9-4 


12-9-5 


12-9-8-2 


12-9-8-3 


12-9-8-4 


12-9-8-5 


12-9-8-6 


12-9-8-7 
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Table 3-1. 


12-11-9-8-1 


11-9-1 
11-9-2 


| 
os 


11-9-8-1 


11-9-8-2 









11-9-8-3 


11-9-8-4 


11-9-8-5 


11-9-8-6 


11-9-8-7 


Internal Code 


TWO LEAST SIGNIFICANT BITS OF ZONE 


11-0-9-8-1 


0-9-2 


0-9-8-2 


0-9-8-3 


0-9-8-4 


0-9-8-5 







SECTION: 


9-8-1 


9-8-2 


9-8-3 


9-8-4 


9-8-5 
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TWO MOST SIGNIFICANT BITS OF ZONE -— 01 


TWO LEAST SIGNIFICANT BITS OF ZONE 























| | 
-0-9- -11-9- : “11-0-9- | 

Saha | 12-0-9-1 12-11-9-1 | 0-1 )  12-11-0-9-1 | 
| | : | 
0010 12-0-9-2 12-11-9-2 11-0-9-2 | 12-11-0-9-2 | 
1 { i 
| | | | | : 
| 0011 | 12-0-9-3 | 12-11-9-3 | 11-0-9-3 | 12+11-0-9-3 | 
| | 
0100 | 12-0-9-4 nee es Br | 11-0-9-4 | -12-11-0-9-4 | 
| | | 
0101 | 12-0-9-5 12-11-9-5 | 11-0-9-5 | 12-11-0-9-5 | 
| 0110 | 12-0-9-6 1221120-6 : 11-0-9-6 12-11-0-9-6 | 
H ! 
| | 
| 0111 | 12-0-9-7 12-11-9-7 ! 11-0-9-7 | 12-11-0-9-7 
| | 
| 1000 | 12-0-9-8 12-11-9-8 | 11-0-9-8 F 12-11-0-9-8 | 
{ i i 
| 1001 | 12-8-1 | 11-8-1 | 0-8-1 | 8-1 | 
} i i | 
: 1910 | 12-8-2 Tsgue | 12-11 8-2 | 
| ¢ | 
| 1011 | 12-8-3 11-8-3 0-8-3 8-3 
| | : : 
| 1100 12-8-4 | 11-8-4 0-8-4 8-4 
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TWO MOST SIGNIFICANT BITS OF ZONE - 10 


TWO LEAST SIGNIFICANT BITS OF ZONE 


























12-11-8-1 11-0-8-1 12-11-0-8-1 
12-11-1 11-0-1 12-11-9-1 
| 0010 | 12-0-2 | 12-11-2 ! 11-0-2 12-11-0-2 | 
| 0011 | 12-0-3 | 12-11-3 | 11-03 12-11-0-3 
| 0100 12-0-4 | 12-11-4 | 11-0-4 12-11-0-4 | 
| 0101 ! 12-0-5 E2-1155 11-0-5 12-11-0-5 | 
| | | | | | 
0110 12-0-6 i 12-11-6 | 11-0-6 12-11-0-6 
0111 | 12-0-7 ! 12-11-7 | Li-0-7 12-11-0-7 | 
! { } 
| 1000 | 12-0-8 | 12-11-8 | 11-0-8 12-11-0-8 ! 
| 1001 12-0-9 12-11-9 11-0-9 12-11-0-9 | 
: 1010 12-0-8-2 | 12-11-8-2 11-0-8-2 12-11-0-8-2 | 
| 1011 12-0-8-3 | 12-11-8-3 11-0-8-3 12-11-0-8-3 
| 1100 12-0-8-4 | 12-11-8-4 11-0-8-4 12-11-0-8-4 | 
| 1101 | 12-0-8-5 | 12-11-8-5 | 11-0-8-5 12-11-0-8-5 
| 1110 12-0-8-6 12-11-8-6 | 11-0-8-6 12-11-0-8-6 
: 1111 | 12-0-8-7 | 12-11-8-7 | 11-0-8-7 | 12-11-0-8-7 | 





Table 3~]. Internal Code (cont.) 
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TWO MOST SIGNIFICANT BITS OF ZONE - 11 


TWO LEAST SIGNIFICANT BITS OF ZONE 































0000 12-0 11-0 0-8-2 0 : 
12-1 114i 11-0-9-1 1 
0001 ; P ‘ 
12-2 11-2 0-2 2 
“oN B K 5 2 
12-3 11-3 0-3 3 
Cc L 7 3 
12-4 114 0-4 4 
one D M U 4 
; 12-5 [is | 0-5 5 
0101 E N Vv 5 
aaiG 12-6 11-6 0-6 6 
F ts) W 6 
12-7 17 0-7 7 
| oe G P | X 7 
! | | 1 
| cag 12-8 11-8 | 0-8 | 8 
H Q | Y | 8 
i 
12-9 11-9 | 0-9 9 
1001 R Zz 9 
12-0-9-8-2 12-11-9-8-2 11-0-9-8-2 12-11-0-9-8-2 
12-0-9-8-3 12-11-9-8-3 11-0-9-8-3 12-11-0-9-8-3 
12-0-9-8-4 12-11-9-8-4 11-0-9-8-4 12-11-0-9-8-4 












11-0-9-8-5 12-11-0-9-8-5 





12-0-9-8-5 12-11-9-8-5 













12-0-9-8-6 12-11-9-8-6 11-0-9-8-6 12-11-0-9-8-6 








12-0-9-8-7 12-11-9-8-7 11-0-9-8-7 12-11-0-9-8-7 


Table 3—1. Interna! Code (cont. ) 
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4. OUTPUT 


ASSEMBLER CARD OUTPUT 


The object code produced by the Assembler is punched into six different card types: 
Element Definition Cards, External Definition Cards, Program Reference Cards, Ex- 
ternal Reference Cards, Text Cards, and Transfer Cards. These card types have the 
following functions. 


The Element Definition Card contains the name, the size, and the origin of the 
element as assigned by the Assembler. 


An External Definition Card specifies the value of a symbol which may be refer- 
enced by other elements. 


tains the name of the element and the number by 


LS ay 


he relocation information for the element. 


4 
= 
pe 
Q 
a 
ct 
a 
pa 
nN 
pes 
je) 
3; 
fa) 
ar 
n 
Ree 
Pu * 
0) 
=] 
et 
ee 
mh 
hte 
) 
Au 
iy 
mB OO 


An External Reference Card contains a label to which the element refers but which 
it does not define. The card also contains a number by which this label is identified 
in the relocation information for the element. 


A Text Card contains the instructions and constants of the element, an address in- 
dicating where the instructions and constants are to be loaded into memory for 
execution, and the relocation information pertaining to the instructions and con- 
stants. The loading address for the instructions and constants is assigned by the 
Assembler to conform with the origin of the element as described in the Element 
Definition Card. The relocation information performs two functions: 


— It permits the relocation of the instructions and constants to an origin other 
than the one given to the element by the Assembler. 


— It provides the information required by the Linker to resolve any external ref- 
erences made in the instructions or constants with the corresponding external 
definitions made in other elements. 
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w The Transfer Card is generated by the END assembler directive. If the END direc- 
tive specifies the address at which execution is to begin, this address appears in 


the Transfer Card. 


The order and number of these cards in the Assembler object code output deck is as 
follows. First there is a single Element Definition Card. Then there are as many Ex- 
ternal Definition Cards as there are ENTRY assembler directives in the source code. 
Then there is a single Program Reference Card followed by as many External Refer- 
ence Cards as there are EXTRN assembler directives in the source code. Then there 
are as many Text Cards as are required to contain the instructions and constants repre- 
sented in the source code deck. Finally, there is a single Transfer Card. 


If the output of an assembly contains no External Reference Cards, it may be loaded 
directly into the UNIVAC 9200/9300 via the Card Program Loader. In this instance, 
the text is loaded at the addresses indicated in the Text Cards, and job execution 
begins at the point indicated in the Transfer Card. The Element Definition Card, any 
External Definition Cards, the Program Reference Card, and the relocation information 
in the Text Cards are ignored by the Program Loader. 


The format of these assembler output cards is as follows. 


Element Definition Card 








Load Key 


Type 


i 
| 
| 
6 Absolute/relocatable 


4 
| 3 | Length 
7 Hote Count 


Program ESID 


Assembled Start Address 


Name 


Program Length 





CONTENTS 
12-2-9 punch 


A (Hollerith) 





17 (or number of columns used less one from Col.11). 


I 
Absolute or relocatable program indication (12 punch | 
if absolute, blank otherwise). 
Sum of the bytes punched (columns 8 through 72). 


External Symbol! Identification assigned by the 
Assembler to this program name. 


The base of this program as assigned by the Assembler. 


The name assigned to this program (the name is left 
justified in the field and is punched in EBCDIC). 


The number of bytes of memory needed by this program. 
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4.1.2. External Definition Card 


FIELD NAME CONTENTS 














the Text Card. If present, column 72 contains a 3 and 
the least significant digit of column 71 also contains 
a 3 indicating that columns 14-16 are to be modified. 


| 1 | Load Key 12-2-9 punch 
1 
2 | Type H (Hollerith) 
3 Length 13 (or number of columns used less one from Col. 11). 
7 | Hole Count Sum of the bytes punched (columns 8-72). 
9 RLD Length Number of columns of RLD information on card (indi- 
| cates 3 or Q). 
| 
10 | Last RLD Column 11 relative number indicating the most signifi- 
cant column of the last item of RLD information on the 
| card. The value is 59 if there is relocation data; other- 
| | wise zero. 
a | Symbol! address | The Assembler assigned value of the symbol field. 
| 
li7-24 Symbol Symbolic name to be referenced by other program(s) 
1 
| | (punched in EBCDIC), 
| 
1072 | RLD | 
| | 


| 
Relocation field. See the description of this field for | 
| 
{ 
| 


4.1.3. Program Reference Card 


COL. FIELD NAME CONTENTS 


Load Key 12-2-9 punch 


Type J (Hollerith) 





Length 13 (or number of columns used less one from Coi.11). 





Hole Count | Sum of the bytes punched (columns 8-72), 
| 8 Program ESID | External Symbol Identification assigned by the 
Assembler to the program name. 
13-16 Assembled Start Address The base of this program as assigned by the Assembler. 
17-24 Name | Element name (same as columns 17 through 24 of the 


Element Definition Card). 


oy Hi 1 3 
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FIELD NAME CONTENTS 


Load Key 12-2-9 punch 


Type K (Hollerith) 


Length 13 (or number of columns used less one from Col. 11). 


Hole Count Sum of the bytes punched (columns 8-72). 


Name ESID External Symbol Identification assigned by the 
Assembler to this symbolic name. 


Symbolic name being referenced by this card 


(punched in EBCDIC). 


4.1.5. Text Card 


FIELD NAME CONTENTS 


Load Key 12-2-9 punch 


Type Q (Hollerith) 





Text Length Indicates the number of columns less one of text 


information on the card. 


Load Address The Assembler assigned location where the text is 


to be loaded. 


7 | Hole Count 








Sum of the bytes punched (columns 8-72). { 


8 | Program ESID External Symbol Identification assigned by the 
Assembler to the program name to which this load 


address is relative. 


RLD length Number of columns of RLD information on this card. 


Last RLD Column 11 relative number indicating the most 
significant column of the last item of RLD informa- 
tion on the card. This number is 59 if there is RLD 


data, otherwise zero. 


11 The value to be loaded at the load address. The TXT 


& following field contains information from columns 11 through 
11+n, where n is the number contained in column 3. 


72 RLD fields begin in column 72 and occur from right 
& preceding to left on the card for the number of columns indicated 
in column 9. Each RLD field is composed of three 


columns. 


Example of RLD field: 





Column 70 contains a name ESID. This points to a value in the linker reference 


table to be applied to the TXT on this card. 
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Column 71 contains a flag. The four most significant bits indicate the operation. 
All zero bits indicate that the reference table value is to be added to 
the text value to obtain the new text value. If the four most significant 
bits of the flag column are 0001, the reference table value is subtracted 
from the card text value to obtain the new text value. 


The three least significant bits of the flag column indicate (in binary) 
the length of the text field in bytes. The remaining bit is a one if the 
field to be modified contains an additional halfbyte. Thrs, the four 
least significant bits would contain the value eight for a four-bit field. 
If all four bits are zero, the field is four bits long and is in the left 
halfbyte. 


Column 72 contains column position. A binary number (relative to column 11) point- 
ing to the most significant column of the text information to be modified. 


4.1.6. Transfer Card 











FIELD NAME CONTENTS 


Load Key 12-2-9 














relative indicator of the first column of the start 
address (indicates Col. 14). The most significant 

4 bits in column71 are 0001 if the reference table 
address is to be subtracted from the card start address 
or 0000 if the reference table address is to be added 
to the card start address to obtain the relocated start 
address. The least significant 4 bits in column 71 
indicate that the start address on the card is 3 bytes 
long. Column 70 contains the ESID that points to the 
value in the reference table to be applied to the card’s ! 











2 Type Y (Hollerith) 
3 Length 5 (or number of columns less one from Col. 11). 
7 Hole Count | Sum of the bytes punched (columns 8-72). 
| 
9 RLD Length | Number of columns of RLD information on the card. 
‘ (Indicates 3 or 0). 
10 Last RLD Column 11 relative number indicating the most signi- 
ficant column of the last item of RLD information on 
the card. (Contains 59 if there is relocation data, 
otherwise 0.) | 
11-13 | Card Count The number of reference type K or text type Q cards 
| which were produced by the assembler for this element. 
14-16 | Start Address The address to which control is given after loading \ 
| this e!ement. | 
70-72 | RLD Relocation field. Column 72 contains column 11 | 
| 


Start address field. 


For all assembler output cards, the PID is left justified in columns 73—76, and a 


Sequence number is punched in columns 77—80. Both the PID and sequence number 
are punched in Holierith. 
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5. LINKER 


When a job consists of more than one element, the elements, which are the output of sep- 
arate Assembler runs, must be combined before they may be loaded as an executable object 
program. This combining, or linking, is done by a utility program called the Linker. The 
Linker inserts the storage addresses for references made from one element to another and 
modifies addresses if an element is relocated. 


A provision is included for dividing the output elements into separate loads or ‘‘phases”’ 
Another provision allows corrections, stated in hexadecimal, to be made to any of the 
elements being linked. These corrections must be in terms of the ultimate absolute addresses 
assigned to each field being changed. 


Most of the input to the Linker consists of the output of one or more Assembler runs. How- 
ever, control cards are supplied by the user to specify: 


— the initial storage address to be allocated to the output element 
(PHASE card) 


the start of a new phase of the output (PHASE card) 


additional external definitions (EQU card) 


corrections to one or more of the elements being linked (REP) 


the end of the input stream (END) 


The Linker provides an output listing including: 


— the control cards on its input, 


— the names and external definitions of the elements being linked and 
the values allocated to each, as well as the number of the phase in 
which it is included. Phases are numbered consecutively from one in 
the order in which they appear in the input. 


Error indications are included in the listing, and most errors cause termination of the 
punched output. The punched card output is in the same form as the assembler output 
cards, except that no relocation data is punched. The output for each phase consists of 
Text Cards and a Transfer Card. 


The Linker increments, if necessary, the address to be assigned to each input element so 
that the base address is a muitiple of four. 


The Linker is capable of either a one or two-pass operation. At the end of pass one a stop 
occurs with a display indicating readiness for pass two. At the end of pass two a stop 
with a display requiring a reply occurs. When the start button is depressed, the Linker 
interrogates this reply to determine its subsequent action, which is to process another 
set of input or to terminate processing. 
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The Linker is assembled separately from its input/output but is linked to the input/output, 
allowing for input from the standard card reader or the 1001, output to serial or row punch, 
and choice of input translation table and the option of a translation for the 48 character 
printer. 


Del: 


eee 


LINKER INPUT 


The major input to the Linker consists of the output of one or more assemblies. The 
input to the Linker is normally formed by placing one element behind the other in 

the order they are to have in storage. Then a PHASE card is placed at the beginning 
of the deck to define the initial storage location and an END card at the end to signal 
the end of the input. If the output element is to consist of more than one phase, each 
input element must be entirely in one phase, with a PHASE card inserted in front of 
the first Element Definition Card in the phase. Each such PHASE card indicates the 
initial address to be allocated to that phase. When the Linker input is arranged in this 
manner, all elements comprising one phase must follow the PHASE card defining that 
phase and precede the PHASE card defining the next phase. 


The order of the input must also be such that the element using an externally defined 
symbol must precede all elements referring to that symbol. If there are any symbols 
for which this is not possible, their definitions may be supplied by EQU cards. If 
this is not desirable, the Linker provides the option of a two-pass operation. The 
first pass recognizes the headers (Element Definition and External Definition Cards) 
and stores the external definitions. The second pass processes the External Ref- 
erence, Text, and Transfer Cards, and produces the output element. 


If desired, a two-pass operation may be avoided by separating the headers of the 
input elements and presenting them first. The procedure is as follows: 


1. Put together the input elements as described above, but without 
control cards; 


Sort out the header cards (12 punch in column 2); 
3, Place the header cards in front of the remaining deck; 


Insert the required control cards, 


Each PHASE card should precede the Element Definition Card for the first element 
in the phase being defined. EQU cards follow a PHASE Card, Element Definition, or 
External Definition Cards. REP cards must immediately precede the Transfer Card of 
the element they are to alter. 


LINKER CONTROL CARD FORMATS 


The control card identifier (CTL, PHASE, EQU, REP, or END) is left justified in 
columns 8—12. Columns 1 to 7 are blank except for the ©QU card on which columns 

1 to 4 contain the symbol being defined. The specifications contained on each control 
card begin in column 14 and are terminated by a blank. 
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CTL 


The CTL card is the first card of the Linker input. The specifications consist of 
two fields separated by a comma: 


n,p 


where n=1 one-pass operation of the Linker, 
n=2 two-pass operation of the Linker; 


p a decimal number representing the largest address available to the out- 
put element. 


Any field may be omitted. The effect is as follows: 


n omitted : one-pass operation. 


pomitted : maximum address to be allocated is not to change. The initial 
value is 16383. 


The CTL card may be omitted, in which case the result is the same as indicated 
above for each field omitted. 


If the Linker is to perform a two-pass operation and produce code for a 16K system, 
the CTL card would be 


PHASE 


A PHASE card defines the name and initial storage address for the output element 
and must be the first or second card of the Linker input, preceded only by the CTL 
card. A PHASE card also precedes the Element Definition Card (type A) for the 
first element of each subsequent load. It specifies the name of the phase and its 
starting address. 


The specifications field has the form 
phase-name, displacement, flag, symbol 


where phase-name_ is a group of up to four alphabetic characters representing the 
name of the phase 


displacement is a decimal number (may be preceded by minus) or a hexa- 
decimal number in the form X’nnnn’ 


flag is C or A for the first PHASE card and C, A, or L for any others. 
C — load address equals the highest core address minus the 
displacement field. 


A — load address is the actual value given in the displacement 
field. 


L — load address is obtained by adding the displacement to the 
value of the symbol. 


symbol is any previously defined symbol. 
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EQU 


An EQU card supplies the definition of a symbol which is not defined in any of the 
elements being linked or which is defined in an element whose position in the input 
deck is later than that of the first element containing a reference to the symbol. 


The specification field of the EQU card has the form: 


value 
or 
value, symbol 
where value is a decimal number, a decimal number preceded by a minus sign, 


or a hexadecimal number in the form X’nnnn’ 


symbol is any symbol which has been defined previous to the EQU card in 
the input deck. 


In the first form above, the binary value represented by the value field becomes the 
value assigned to the symbol appearing in the label field of the EQU card. For an 
EQU card with a specification field of the second form above, the value of the 
previously defined symbol is added to this value to yield the value of the symbol 
being defined. 


An EQU card must follow a PHASE card, an Element Definition Card, an External 
Definition Card, or another EQU card. It must precede the body of the first element 
containing a reference to the symbol defined. The symbol, contained in the specifi- 
cation field, must have been previously defined. 


If the Linker control deck contains more than one EQU card defining the same 

symbol, an error indication is made on the listing. However, such an error does 
not terminate the punching of output. Instead, the Linker continues to treat the 
definition given in the first such EQU card as the definition for the symbol. 


END 


The END card indicates the end of the input to the Linker and is the last card in 
the deck. 


The specification field has the same form as that of the EQU card, and is processed 
in the same way to produce a single value which is interpreted as the address at 
which to begin executing the last phase being produced by the Linker. As such, 

this value is punched into the Transfer Card at the end of the output element. 


If the output of the Linker consists of more than one phase, the transfer address 
of each phase but the last is determined as follows: 


1. Normally, the transfer address of the phase is the address from the first 
Transfer Card in the input to the phase. 


2. If no Transfer Card in the input contains an address, the transfer address 
is the lowest address assigned to the phase. 
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The specification field of the END card may also be blank. In this case the trans- 
fer address punched into the terminal Transfer Card of the output element is the 
address from the first Transfer Card of an input element in that phase containing 
an address. If no Transfer Card of an input element contains an address, the 
lowest address assigned to that phase is punched into the terminal Transfer Card. 


REP 

The REP (Replace) cards specify changes which are to be made to an assembled 

element. The REP cards are placed immediately in front of the Transfer Card of 

the element to be altered. Addresses and data are specified in hexadecimal in the 

same form they are to have in the output element. No relocation or linking facilities 

are provided by the Linker for this data. 

The form of the specifications field is 

address, data, data, ... 

where address’ is a field of from one to four hexadecimal digits specifying the 
storage address of the leftmost byte of data to be altered as a 
result of this card. 

data is a field of from one to four hexadecimal digits specifying data 
to be right justified in a halfword of storage. The address field 
is followed by a variable number of such data fields specifying 
the contents of successive halfwords cf memory. The fields are 
separated by commas and terminated by a blank. 
EXAMPLE 


Assume two separately assembled elements, A and B. A was assembled at an origin 
of 0 and has a length of 100, while B was assembled at an origin of 400 and has a 
length of 200. Further, A externally defines one entry point M, which is assigned an 
element relative address of 50, and makes external references to symbols X, Y and 

Z. B on the other hand externally defines symbols X, Y, and Z and makes an external 
reference to M. Symbols X and Y are entry points with relative addresses of 475 and 
550, respectively, while Z is defined as having an absolute value of 25. Finally, 
neither the A nor the B element Transfer Card specifies a starting address. The object 
code decks for elements A and B have the following construction. 


Element A 

a. One Element Definition Card specifying that this element is named A and has an 
origin of 0 and a length of 100. 

b. One External Definition Card specifying M as an externally defined symbol with 


an element relative value of 50. 


c. One Program Reterence Card specifying that this element is named A, that this 
name has an External Symbol Identification (ESID) number of 1, and that element 
A has an origin of 0. 


d. Three External Reference Cards specifying that X, Y, and Z are externally ref- 
erenced symbols which have ESIDs of 2, 3, and 4, respectively. 
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e. Text Cards containing the instructions and constants of element A and the re- 
location information for these instructions and constants. Two examples may 
clarify the nature of this relocation information: 

1. An instruction may refer to some other part of element A. This reference is 
relative to the origin of the element. If the origin moves, the reference must 
be adjusted accordingly. The associated relocation information indicates 
where this reference is made in element A and specifies the ESID of element 
A, indicating that this is an element relative reference. 

2. An external reference may be made. In this case, the reference is undefined. 
The associated relocation information indicates where in element A this 
reference is made and specifies the ESID identifying the undefined symbol 
referenced. 

f. One Transfer Card. 

Element B 

a. One Element Definition Card specifying that this element is named B and has an 
origin of 400 and a length of 200. 

b. Three External Definition Cards. 

1. One specifies that X is an externally defined symbol and that it has an element 
relative value of 475. 

2. One specifies Y with an element relative value of 550. 

3. One specifies Z with an absolute value of 25. 

c. One Program Reference Card specifying that the element is named B, that it has 
an ESID of 1, and that it has an origin of 400. 

d. One External Reference Card specifying M as an externally referenced symbol 
with an ESID of 2. 

e. Text Cards containing the instructions and constants of element B and the re- 
location information for these instructions and constants. 

f. One Transfer Card. 


These two decks are represented schematically in Figure 5-1. Suppose elements A 
and B are to be linked into one job having an origin of 1000 and whose initial execu- 


tion address is to be the beginning of element A. The origin would be specified in a 
PHASE card, the transfer address in an END card. The input to the Linker for a one- 
pass operation would appear as shown in Figure 5—2. 


The Linker reads the PHASE card and sets the location counter to 1000 in preparation 
for creating a job to be loaded beginning at memory location 1000. The Linker then 
reads the header cards and sets up the reference table. Each entry in the reference 
table consists of three fields. 


1. The name which this entry describes. 
2. The location assigned to this name. 


3. The relocation factor for this name. The relocation factor is the amount by 
which the value assigned to the name by the Assembler must be adjusted to 
arrive at the value to be assigned to the name by the Linker. 
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TRANSFER 


TEXT AND 
RLD INFO 


EXT :‘REF:Z 
ESID 4 


ELEMENT 
A 


EXT REF Y 
ESID 3 


EXT REF X 
ESID.2 


NAME A 
ESID 1 
ORIGIN 0 


ELT REL 50 


ELEMENT A 
ORIGIN 0 
LENGTH 100 


Figure 5-1, 
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TRANSFER 


TEXT AND 
RLD INFO 


EXT REF M 
ESID 2 


ELEMENT NAME B 
B ESID 1 
| ORIGIN 400 


EXT DEF Z 
ABS VAL 25 


EXT DEF Y 
ELT REL 550 


EXT DEF X 
ELT REL 475 


ELEMENT B 
ORIGIN 400 
LENGTH 200 


Elements A and B Deck Structure 
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END 
START A 
TRANSFER 

















ELEMENT B setre gis 
BODY RLD INFO 
EST REF M 
ESID 2 
NAME B 
ESID 1 
ORIGIN 400 





TRANSFER 


TEXT AND 
RLD INFO 


EXT REF Z 
ESID 4 

EXT REF Y 
ESID 3 

EXT REF X 
ESID 2 


NAME A 
ESID i 
ORIGIN 0 








ELEMENT A 


BODY 








EXT DEF Z 
ABS VAL 25 


EXT DEF Y 
ELT REL 550 








ELEMENT B 











EXT DEF X 
ELT REL 475 


HEADER 


ELEMENT B 
ORIGIN 400 
LENGTH 200 










EXT DEF M 
ELT REL 50 


ELEMENT A 
ELEMENT A 
ORIGIN 0 HEADER 
LENGTH 100 


PHASE 
ORIGIN 1006 






PHASE 


Figure 5—2, Linker Input 
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For example, the name ‘‘A’’ is to be assigned a value of 1000 by the Linker. It was 
assigned a value of 0 by the Assembler; therefore, its relocation factor is 1000. 


As a second example, consider the name ‘‘B’’. 


1. Since element A begins in location 1000 and is 100 bytes long, the name 
‘‘B”’ is assigned a value of 1100 by the Linker. 


2. While the body of element A is being processed, the name ‘‘B’’ has a 
relocation factor of 1100, since the name ‘‘B’’ is undefined in element A. 


3. While the body of element B is being processed, the name ‘‘B’’ has a 
relocation factor of 700, since in element B the Assembler assigned a 
value of 400 to the name ‘‘B’’. 


The reference table produced as a result.of processing the header cards in Figure 
5—2 is shown in Figure 5-3. 


The Linker then reads the Program and External Reference Cards for element A. 
The information from these reference cards is used by the Linker to build an ESID 
table. Each entry in the ESID table consists of two fields: 


1. The ESID from the reference card. 


2. The reference table entry number of the symbol to which the ESID is 
assigned. 


The Program Reference Card is also used to determine the relocation factor for the 
element name. The result of processing the reference cards is shown in Figure 5—4. 


The Linker then processes the text of element A. For each instruction or constant 
on the input text cards it produces an instruction or constant on an output Text 

nm 1 FONG oe GS Ee ee By AO Ek leet em melas pul Ol Soe NE mel Tha ndAdenaa at 
Cara. ine apSolute portions Of tne text are prouuceu Uliaiteicu. zune auuieoss ar 
which the text is to be loaded is adjusted by the relocation factor for element A. 


If a portion of the text is relocatable, then there is associated with it relocation 
information specifying an ESID of 1. In this case, the Linker looks up in the ESID 
table the associated reference table entry number. It then looks up in the reference 
table the relocation factor (1000) and adjusts the text by the relocation factor. The 
input text is then relocated to the origin specified by the PHASE card, and this 
relocated text is produced as output. 


The Linker performs a similar function if a portion of the text makes an external 
reference. (Assume the reference is made to the symbol Y.) There is associated with 
this text relocation information specifying the ESID of the external reference (3). 
The text is adjusted by the relocation factor (1250) determined by the relation be- 


tween ESID and reference table entry number (5). This defines the external reference, 
and the resolved text is produced as output. 
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ELEMENT A 





BODY 


NAME A 
ESID i 


GRiGiIN G 






EXT DEF Z 
ABS VAL 25 


EXT DEF Y 
ELT REL 550 





EXT DEF X 
ELT REL 475 


ELEMENT B 
ORIGIN 400 
LENGTH 200 












EXT DEF M 
ELT REL 50 


ELEMENT A 
ELEMENT A 

ORIGIN 0 HEADER 
LENGTH 100 


PHASE 


ORIGIN 1000 PHASE 


ELEMENT B 


EXT REF Z 
ESID 4 
EXT REF Y 
ESID 3 
EXT REF X 
ESID 2 


ELEMENT B 


END 
START A 
TRANSFER 


TEXT AND 
RLD INFO 


EXT REF M 
ESID 2 


NAME B 
ESID 1 
ORIGIN 400 


TRANSFER 


TEXT AND 
RLD INFO 













BODY 





















REFERENCE TABLE 


RELOCATION 
FACTOR 


ENTRY 


NUMBER NAME 


VALUE 


A 1000 1000 


1 
2 M 1050 1050 


HEADER 


1175 1175 


Figure 5~3. Header Processing 
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fe END 


START A 





























TRANSFER 


TEXT AND 


ELEMENT B RLD INFO 


BODY EXT REF M 


ESID 2 


NAME B 
ESID 1 
ORIGIN 400 


TRANSFER 


TEXT AND 
RLD INFO 





ELEMENT A ESID TABLE 
BODY ba Rebs ENTRY 
ESID 4 NUMBER 
EXT REF Y 
ESID 3 
EXT REF X 
ESID 2 
NAME A 
ORIGIN 0 | 


REFERENCE TABLE 


RELOCATION 
VALUE FACTOR 


1000 1000 





ENTRY 
NUMBER NAME 
Le | 
Es 
3 










Figure 5—~4. ESID Processing for Element A 
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The Linker recognizes the end of element A by means of the Transfer Card. It then 
reads the Program and External Reference Cards for element B and adjusts the 
reference and ESID tables accordingly. The result of this adjustment is shown in 
Figure 5—5. Note that the relocation factor for the name ‘‘B”’ is changed. 


The Linker then uses the ESID and reference tables to process the text of element 

B and produces the related output text completely relocated and with all external 
references defined. In response to the END card, the Linker produces a Transfer 
Card with a value of 1000 (the value of the name ‘‘A’’) in it for a Transfer Address. 
Thus, the output of the Linker is a deck of Text Cards with no relocation information, 
followed by a Transfer Card. 


If a third element were to follow element B as input to the Linker, the relocation 
factor for the name ‘‘B’’ would be set back to 1100 by the Linker before it processed 
this third element. 












END 
START A 


TRANSFER 


ELEMENT B 






TEXT AND 
RLD INFO 








BODY 


ESID TABLE 
ENTRY 
A Cc 
EXT REF M ESID NUMBER 


ESID 1 
ORIGIN 400 






REFERENCE TABLE 


ENTRY RELOCATION 
NUMBER NOME RReOR FACTOR 






1000 1000 
1050 1050 


1100 ‘700 


ea ea 
es 
ce a 








1250 1250 





Figure 5—5. ESID Processing for Element B 
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APPENDIX A. PREASSEMBLY 
MACRO PASS 


The preassembly macro pass of the UNIVAC 9200/9300 Card System is used in conjunction 
with the Assembler to promote ease and efficiency in preparing programs for execution on 
the UNIVAC 9200/9300. A schematic of the preassembly macro pass is shown in Figure 


A-1. 









MACRO 
INSTRUCTION 
DECK 







MACRO 
LIBRARY DECK 


UNIVAC 


9200/9300 


SOURCE CODE 
DECK 
READY FOR 
ASSEMBLY 





Figure A~]. Schematic of Preassembly 
Macro Pass Operation 


















UNIVAC 9200/9300 
CARD ASSEMBLER 


Appendix A 


SECTION: 


UP-4092 


The macro library is a card deck in which the macros in the library are punched in a com- 
pressed form to minimize both library passing time and memory storage space. The macro 
library is read in first and is stored in memory. Then the card deck of macro instructions 
is read in. This deck contains the parameters and controls required to generate a source 
code deck in Assembler format. The output deck represents the selected library routines 
modified as instructed. The source code deck may be combined with user source code 
cards and assembled as one element, or it may be assembled as a separate element and 
linked with other relocatable elements to make up a program. 


Being a card deck, the library is separable, and only those routines called for during the 
operation of a particular preassembly macro pass need be in the library for storage. 


1. MACRO INSTRUCTION FORMAT 


A macro instruction is similar in form to a source code instruction; it has a label 
(optional), an operation code, and an operand consisting of one or more expressions 
separated by commas. The prime difference is that the macra instruction causes the 
generation of a series of source code instructions representing a number of Assembler 
operations; whereas a source code instruction causes the Assembler to do one specific 
operation. 


The format for a macro instruction is as follows: 
label operation Py,P9,P3,...,Py, Ny=P,.4,N9=Pp42,N3= Pai 3c Nm=Paim 


The label may be any symbol, but is not necessarily assigned the current value of the 
location counter. The operation is the name of the macro routine to be selected from 
the library. The operand, P, through P,,,,, is a sequence of expressions specifying 
parameters. The parameters are represented either as positional parameters or as key- 
word parameters. 


1.1. Parameters 


Positional Parameters All positional parameters must be specified before any key- 
word parameters may be specified. The order of the expressions in the operand 
determines the order of the parameters specified. Parameter specifications are 
separated by commas. When a positional parameter specification is omitted, the 
comma must be retained to indicate the omission. Thus, if a macro has three 
positional parameters and the second one is not specified, the operand appears 

as follows: 


P25) 3 

If the third parameter is not specified, instead of the second, the operand is written: 
P1,P9 

Thus, no trailing commas need be present. 


Keyword Parameters The specification of a keyword parameter is as follows: 


N=P 
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where N is the name of the parameter (any symbol is a legitimate keyword parameter 
name) and P is the parameter specification (a value or a character string). Keyword 


parameter specifications are separated by commas; however, the comma need not 
be retained if the specification is omitted. There must be a comma between the last 
positional parameter and the first keyword parameter. The order of the keyword 
parameter specifications is not significant. For example, if a macro has three key- 
word parameters, the operand of the macro instruction might be: 


N,=P1,N2=P2,N3=P3 
or 

No=P9,N1=P1,N3=P3 
and so on. 


A macro may have positional and/or keyword parameters with commas separating the 
specifications. For example, the operand of a macro instruction with three positional 
and two keyword parameters might be as follows: 


P1,P9,P3,N,=P4,N3=Pc 


The number of parameters which may be specified with one macro instruction depends on 
how much space is required to store the specifications. One macro instruction may normally 
specify as many as 50 parameters in its operand. When the operand overflows the space 
pravided on one card, provision is made to continue the operand on the following card by 
putting a non blank in column 72. The continuation of the operand begins with the first non- 
blank in or after column 14. The macro pass searches for a continuation card as soon as 
one of the two following events occurs: 


1. Information is taken from column 71 of the current card. 


2. A comma followed by a space is detected in the current card. 
Columns 1 through 13 of a continuation card must be blank. 
If the information on a card is terminated prior to column 71 by means of a comma followed 


by a Space, comments may be written after the space. For example, a macro instruction 
with three keyword parameters might be written as follows: 


LABEL & OPERATIONS OPERAND COMMENTS 


1 8 14 72 
Pi | AGRO! Nishi, COMMENT iit iti 


Eee teeth Ge atic COMME X 
B E 
a 


The specification of a parameter may be a character string or an expression. A character 
string may not contain an equal sign or a comma and may have a maximum of seven 
characters. 
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WRITING MACROS FOR THE LIBRARY 


The routines for the macro library are written in standard assembler source code. They 

are then passed through a special run to put them into the compressed form expected by 
the preassembly macro pass. To distinguish one macro from another in the library, three 
directives are used: PROC, NAME, END. 


. PROC Directive The first source code statement of a macro in the library is a PROC 


directive, which has the following form: 
label PROC (operand optional) 


The label may be any symbol, but is optional, and when used the label in the macro 
instruction calling on the macro is substituted for the PROC label whenever the 
PROC label appears in the macro. For example, suppose the symbol MOVE were 
specified for the label of a macro instruction, that the label of the PROC directive 
of the associated macro was NAME, and that the macro contained the following line 
of source code: 


NAME MVC DEST,ORIG 


Then, the source code generated by the preassembly macro pass would appear as 
follows: 


MOVE MVC DEST,ORIG 


If the PROC directive does not have a label but the macro instruction does, the pre- 
assembly macro pass assigns the label to the first line of source code generated in 
processing the macro. 

NAME Directive The second iine of a macro library routine musi be a NAME directive, 
which has the form: 


label NAME 


This is the call name for the macro and is the same as that specified in the operation 
field of the macro instruction. The name may have as many as five characters, the 
first of which must be alphabetic, the other four alphanumeric. 


END Directive The end of a macro library routine is indicated by an END directive. 
It has no operand and requires no label. 


If the following macro is in the library: 
PROC 
MOVE NAME 


MVC DEST,ORIG 


END 
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then the macro instruction: 


MOVE 
iS equivalent to the source code instruction: 
MVC DEST,ORIG 


Note that none of the macro directives (PROC, NAME, END) are produced as 
output of the preassembly macro pass. 


3. INCORPORATING PARAMETERS INTO MACRO CODING 


The operand of a PROC directive, when used, has the following form: 
p,ti,N4,N5,N3,..25Niy 


The first expression (p) in the operand is a symbol used to address the parameters for 
the macro. This expression and its use are explained later in this section. The second 
expression (n) is the number of positional parameters associated with the macro. The 
series (Nj,...N,,) are the names of the keyword parameters. Any symbol is a legitimate 
keyword name. Listing the keyword parameters in this way makes them, in effect, posi- 
tional parameters to the macro. For example, suppose the PROC directive has the 
following form: 


PROC p,3,N1,N2,N3 


The macro has three positional parameters, Pl, P2, and P3. It also has three keyword 
parameters, N1, N2, and N3. Thus, the keyword parameters become, in effect, positional 
parameters P4, P5, and P6. 


The values specified for parameters are substituted in the macro coding for expressions 
of the following form: 


p(n) 


where p is the first expression in the PROC directive operand and n is the number of 
the positional parameters. The first has a number of one, the second, two; and so forth. 
As an example, if the following macro is in the library: 


PROC P,0,DEST,LGTH,ORIG 
MOVE NAME 
MVC P(1)(P(2)),P(3) 


END 
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then the macro instruction 
MOVE DEST=OUT,LGTH=16,ORIG=IN 
after the preassembly macro pass operation, is equivalent to the source code instruction: 
MVC - OUT(16),IN 
If a parameter value is not specified, the preassembly macro pass assigns a value of 
binary zero to the parameter. 
4. DIRECTIVES 


4.1. DO Directives 


A DO directive has only one expression in its operand. It is equal to a value of 
binary zero or binary one. A DO directive controls all lines following it up to its 
associated ENDO directive. For example, in the following sequence of coding: 


DO 1 
2 
DO 2 
4 
5 
ENDO 6 
7 
8 
ENDO 9 


the first ENDO directive is associated with the second DO directive, the second 

ENDO directive with the first DO directive. In other words, DO and ENDO directives 
are paired to produce nests. Thus, the first DO directive controls lines 2 through 8, and 
the second DO directive controls lines 4 and 5. 


If the operand of a DO directive has a value of one, the lines it controls appear in 
the source code produced by the macro pass; if the operand has a value of zero, the 
lines it controls do not appear. For example, if the following macro is in the library: 


PROC P,0,ACT 
MOVE NAME 

DO P(1) 

MVC P,0,ACT 

ENDO 


END 
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then the macro instruction 
MOVE ACT=1 
would produce the instruction 
MVC DEST,ORIG 
in the source code produced by the macro pass ; whereas, the macro instruction 
MOVE ACT =0 
would not produce the instruction in the source code. 
(Note that the macro instruction 
MOVE 
would also cause the suppression of the instruction.) 


GOTO Directive 


The directive GOTO is used to direct the macro pass to transfer control in the 
production of source code from a macro. A GOTO directive has one expression in 
its operand, which must be a label. This label must be the label of a LABEL dir- 


ective. For example, if the following macro is in the library: 


PROC P,0,FOUR 
MOVE NAME 

DO P(1) 

MVC DEST(4),ORIG 

GOTO END 

ENDO 

MVC DEST(8), ORIG 
END LABEL 

END 


then the macro instruction: 

MOVE FOUR=1 
would produce the instruction: 

MVC DEST(4),ORIG 
while the macro instruction: 

MOVE 
would produce the instruction: 


MVC DEST(8),ORIG 
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4.3. NAME Directive 


More than one NAME directive may follow the PROC directive of a macro. (However, 
all the NAME directives in a macro must immediately follow the PROC directive.) 
Each such NAME directive specifies a different name for the same macro. 


The object of giving a macro more than one name is to permit reference to different 
versions of the procedure embodied in the macro. The versions are distinguished with- 
in the macro by means of the operands of the NAME directives. 


Only one expression may appear in the operand of a NAME directive and may be as- 
signed a value ranging from zero through 216_1. This expression is essentially a 
parameter of the macro; it may be addressed in the macro as: 


p(0) 
where p is the first expression in the PROC directive operand; and consequently, it may 


be used to distinguish between versions of a macro. For example, if the following macro 
is in the library: 


PROC P 
MV4 NAME 4 
MV8 NAME 8 
MVC DEST(P(0)),ORIG 
END 


then the macro instruction 
MV4 
would produce the source code 
MVC DEST(4),ORIG 
while the macro instruction 
MV8 
would produce 
MVC DEST(8),ORIG 
If a NAME directive has no operand, the parameter p(0) is assigned a value of zero. 


If a macro has no parameters and it makes no reference to the operand of any of its 
NAME directives, then its PROC directive has no operand. 
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RELATIONAL OPERATORS 
The relational operators are: 
= > < 


A relational operator may be used to compare two terms. If the condition specified by 
the operator holds between the terms, the value of the expression is one; otherwise the 
value of the expression is zero. For example, given the expression: 


P(1)=YES 


if YES is specified for the first parameter of the macro, then the value of the 
expression is one; otherwise it is zero. 


SET VARIABLES 


A set variable is a symbol set by the macro pass to a value defined by an expression. 
Before a set variable may be set, it must first be declared by a GBL, or an LCL directive. 


GBL Directive 


Set variables declared by a GBL directive are called global set variables. The tormat 
for the GBL directive is as follows: 





LABEL & ene OPERAND 6 
14 
aca Zann 
Peeeon o eeed reer cere manen mmemeiraes 


The symbol, G%nn, in the operand is the set variable being declared and nn may vary 

between 00 and 49. A maximum of 50 global set variables may thus be used in any one 
macro library. Once declared, a global set variable remains declared for the remainder 
of the macro pass operation. 

LCL Directive 

Set variables declared by an LCL directive are called local set variables. The format 


is as follows: 


LABEL & Rene OPERAND 6 
14 


Tf hen Yann peed 





The symbol, L%nn, in the operand is the set variable being declared and nn may vary 
between 00 and 49. A maximum of 50 local set variables may thus be used in any one 
macro. The declaration of a local set variable is unique to the macro currently being 
processed by the macro pass operation. Its subsequent use by another macro during 
the same macro pass operation necessitates that it be declared and set again. 
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SET Directive 


The macro pass operation sets a set variable when it encounters a SET directive, 
which has the following form: 


LABEL +t OPERATION OPERAND 7) 
4 


1 8 1 
| |sen | eee 


Sad py ia eds aie a eg age UL ae eg 


The symbol in the label field identifies the global or local set variable being set; 
the expression in the operand is the value to which the set variable is to be set. The 
value of the expression may range from zero through 2*9-1. Until a GBL or LCL var- 
iable is set by a SET directive, it has a value of zero. Once it has been set to a 
specific value by a SET directive, the set variable retains that value until it loses 
its declaration or is set to another value by another SET directive. 


Declaring a set variable does not affect its value. Moreover, it does no harm to de- 
clare a set variable more than once if it is convenient to do so. 


The following is an example of the use of a local set variable. If the following macro 
is in the library: 


PROC P,0,ACT 
MOVE NAME 
BCL L%00 
L%00 SET P(1)=YES 
DO L%00 
MVC DEST,ORIG 
ENDO 
END 


then the macro instruction 
MOVE ACT=YES 
would produce the source code instruction 
MVC DEST,ORIG 


while any other form of the MOVE macro instruction would suppress production of the 
source code instruction. 
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The following is an example of the use of a global set variable. Assume the following 


two macros are in library: 


PROC P,0,ACT 
GIVE NAME 
GBL G%00 
G%00 SET P(1)=YES 
DO G%O0 
MVC DEST,ORIG 
ENDO 
END 
PROC 
TAKE NAME 
DO G%00 
MVC ORIG,DEST 
ENDO 
END 


If the only macro instructions in the macro instruction deck for a particular macro 
pass are the following: 


GIVE ACT=YES 
TAKE 


in the order shown, then the following source code would be produced: 


MVC DEST,ORIG 
MVC ORIG,DEST 


If the only macro instructions in the macro instruction deck for a particular macro 
pass are the following: 


GIVE 
TAKE 


no source code would be produced. 
If the only macro instructions in the macro instruction deck are the following: 


TAKE 
GIVE ACT=YES 


then the following source code would be produced: 
MVC DEST,ORIG 


Thus, the value of a global set variable is a function of the order of the macro 
instructions in the macro instruction deck. 
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LABELS USED IN UNIVAC PRODUCED MACROS 


It should be noted that if the output of a macro pass is to be combined with user source 
code cards and assembled as one element, any symbol used as a label in a source code 
instruction produced by the macro pass may not be used as a label in the user’s own code. 
To avoid the necessity of the user checking a list of symbols used in Univac written 
macros, a special feature has been incorporated in the Assembler to allow all such 
symbols to incorporate as their second character a question mark. 


MACRO INSTRUCTION DECK 


Regardless of the order of the macro routines in the library, the macro instruction deck 
may be in random order with respect to the library, and a particular macro may be ref- 
erenced as many times as desired. The order of the macro instructions does determine the 
sequence of the source code instructions generated as output of the macro pass operation. 


During the macro pass operation, any cards in the macro instruction deck that are not 
macro instructions referring to macros in the macro library are reproduced unchanged 
in the output source deck. The macro pass operation recognizes the end of the macro 
instruction deck by means of an END card which it reproduces and includes at the end 
of the output source code deck. 
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APPENDIX B. INPUT OUTPUT CONTROL 
SYSTEM (IOCS) 


GENERAL DESCRIPTION 


The Input Output Control System (IOCS) provides the user with tested input/output 
routines to control the data which are the input or output of programs written in Assem- 
bler language. IOCS consists of two parts: 


(a) the input/output routines themselves which are macros and generated as a result 
of macro calls. The macros used to generate the input/output routines are called 
declarative macro instructions. 


(b) The macro instructions used by the worker program to communicate with the input/ 
output routines. These macro instructions are called imperative macro instructions 


GENERAL USAGE 


/output 
operations required by the system. Since not every source program requires every 
routine or its variable functions, Univac provides a Preassembly Macro Pass program 
which in effect is a generator capable of adapting each input/output routine to the 
requirements of the user. 


The Preassembly Macro Pass first reads declarative macro instructions made by the 
user describing the input/output operations required by the application. Based on these 
instructions the Preassembly Macro Pass selects the required routines from the macro 
library, develops them for the specific application, and punches them into cards in the 
Assembler language format. They may then be assembled as part of the source program 
or assembled separately and linked with the user program at load time. This function 

is provided by the UNIVAC 9200/9300 Card Linker program. 


The user communicates with the IOCS routines through use of macro calls (imperative 
macros) in his main program. Typical imperative macro instructions are OPEN, CLOSE, 
GET for an input file, and PUT for an output file. These imperative macro instructions 
are related to the input/output routine to which they refer by means of a file name. The 
same file name appears in the calling sequence of all of the imperative macro instruc- 
tions referring to one file and also appears as the label of the declarative macro instruc- 
tion generating the input/output routine for the file. 
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DEFINITION STATEMENTS (DECLARATIVE MACROS) 


The programmer must use definition statements to describe to the Preassembly Macro 
Pass the characteristics of the particular input/output file to be processed. These 
statements are then used by the macro pass to specialize the particular input/output 
routine to meet the requirements of the file and the program. 


Each input/output device required by the program must be defined by means of these 
definitions. A definition statement 1s herein defined as consisting of one Header Entry 
card and a number of Detail Entry cards. In a definition statement, each header and 
detail entry card must have a character punched in column 72, except the final detail 
entry card which must not contain this continuation character in column 72. 


Header Entry Card 


A header entry card is the first card of a definition statement and requires two items of 
information. The first is the symbolic name of the file assigned by the user and is entered 
in the label field of the card. The symbol may consist of as many as four characters and 
must adhere to the Assembler language rules for labels. The other item is written in the 
operation field and must be one of the following: 


1. DTFCR — DEFINE THE FILE FOR THE CARD READER 
2. DIFPR — DEFINE THE FILE FOR THE PRINTER 
3. DTFRP — DEFINE THE FILE FOR THE READ/PUNCH 


4. DTFCC — DEFINE THE FILE FOR THE CARD CONTROLLER 


For example, the header entry card for a reader routine with a file named ‘‘MSTR’”’ 
would appear as follows: 
LABEL 


OPERATION OPERAND 







MSTR 


Detail Entry Cards 


The detail entry cards are used to define parameters such as mode of processing, buffer 
area name, and print bar. 


Each detail entry card is composed of a key word immediately followed by an equal (=) 
Sign which is in turn followed by one specification. A comma must immediately follow 

the specification for each detail entry card in the definition statement except for the final 
detail entry card. A given detail entry must be used only once in each definition statement. 
Entries which do not apply to a particular application should be omitted. The summary of 
detail entry cards listed in Appendix B, 4. gives the optional as well as the required 
detail entry cards for a given peripheral device. The format for a detail entry card, 

with the continuation character in column 72, is as follows: 









OPERATION OPERAND 


key word = specification, 
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Block Size Entry (BKSZ) 


This entry must be provided for all printer files. The key word is BKSZ. The allowable 
specifications are 96, 120 or 132 as determined by the number of print positions avail- 
able. The user-defined work area where print images are made available to IOCS must 
contain the same number of bytes as there are print positions available. The key word 
and specification for 132 print positions have the following form in the operand field: 


BKSZ =132 


Channel Entry (CHNL) 


This entry is used to define the general purpose channel to which the UNIVAC 1001 
Card Controller is connected. The key word is CHNL; the allowable specification is 
one of the general purpose channels 5 through 12. The key word and specification for a 
channel entry for general purpose channel five have the following form: 


CHNL-5, 
Control Entry (CNTL) 


This entry must be provided for all files to which a CNTRL macro instruction is 
directedin the main program. 


The key word is CNTL. The specification is YES. 
CNTL=YES, 


CNTL is a detail entry card within a definition statement. CNTRL is an imperative 
macro and its use is described in a later section. 


End-of-File Address Entry (EOFA) 


This entry is used to specify the symbolic name of the end-of-file routine provided 
by the user. The key word is EOFA and the specification is the symbolic name of 
the user end-of-file routine. The format for an end-of-file routine labeled END is as 
follows: 


EOFA=END, 


When a GET macro instruction is issued for an input file, if the image to be delivered 
is an end-of-file card, IOCS jumps unconditionally to the user end-of-file routine. 


An end-of-file card contains a slash (/[0-1 punch]) in column one and an asterisk in 
column two. (In actuality, the card system IOCS routines recognize an end-of-file card 
by means of the slash in column one alone.) An end-of-file card must be followed by 
other cards in the input hopper to avoid a hopper empty indication before the end-of- 
file card is sensed. The following cards may be special if the user has some purpose 
for them (such as an overlay to be loaded); otherwise, their content is not significant 
and any cards the user wants may be used (such as blank cards or more end-of-file 


cards). 
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For the online card reader, when control is transferred to the user end-of-file address. 
the end-of-file card image is in the work area and the image of the card immediately 


following the end-of-file card is in the input area. 


For the Card Controller, there is no specified input area, since the memory of the 
Card Controller serves the purpose. When control is transferred to the user end-of- 
file address, the end-of-file card image is in the work area. If the end-of-file card 
image is delivered in response to a transfer function, the end-of-file card image is 
also in the memory of the Card Controller, and the card immediately following the 
end-of-file card is immediately in front of the read station. If the end-of-file card 
image is delivered in response to a transfer-and-read function, the image of the card 
immediately following the end-of-file card is in the memory of the Card Controller. 


If the user is using only the send-and-receive functions of the Card Controller, 
detection of end-of-file is a user responsibility. In all other cases, the end-of-file 
address entry is mandatory for all input and combined files. 


The Function Entry — 1001 Card Controller (FUNC) 


This entry specifies the symbolic name of a one byte user-defined area where the 
required function is stored before each GET or PUT macro instruction. 


The key word is FUNC. The specification is the label of the one byte user area, and 
for a function area labeled CCXF, has the following form: 


FUNC=CCXF 


Allowable Functions for the 1001 Card Controller 


The following table illustrates the allowable hexadecimal! values which may be 
stored into the user-defined one byte area before each GET or PUT macro instruc- 
tion is issued. Once set the area may remain the same or be altered as desired. 


| 
HEXADECIMAL VALUE | FUNCTION SPECIFIED 


a see ons Sa eee |e, eee eee iene lt eRe He ee et eee ES 
08 | Transfer and Read Primary 
09 | Transfer and Read Secondary 
00 | Transfer Primary 
01 | Transfer Secondary 
02 | Transfer Primary and Secondary 
OA | Transfer and Read Primary and Secondary 
20 | Send Data to 1001 (1001 code only) 
10 | Receive Data from 1001 (1001 code only) 
| 
The GET macro is used with all functions but ‘‘Send Data to 1001°’. With this func- 


tion a PUT macro is used. 
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Transfer-and-Read Functions 


The previous image read into the 1001 Card Controller is transferred into the 
9200 memory and another image is read into the 1001. The function for the 

first GET executed after opening a Card Controller file should be a transfer- 
and-read function which, in contrast to the general case, causes the first card 
in the feed specified to be read and transferred, and the second card to be read. 


Send-and-Receive Data Functions 


These functions are not available on the standard board. However they are pro- 
vided for by IOCS in the event the user wishes to modify the standard board for 
a particular application. 


No translation is provided for these functions and they must be performed in 1001 
mode only. 


The user work area must contain one byte more than is required for the data to 
be sent or received. The extra byte must be the first byte of the area and must 
contain the number of characters to be transmitted. This first byte must not be 
in 1001 mode, but must contain a binary number. 


Typically, the data sent to the 1001 contains some function character the modified 
board is to interpret, as well as data to be used in the execution of the function. 


For example, assume the board has been modified to interpret the code of a hexa- 
decimal value of 77 as a search primary for a name. The following steps implement 
this function. 

(1) Set function entry area to a send-data function. 

(2) Store hexadecimal 77 into the second byte of the work area. 


(3) Store n 


(4) Store a binary 7 (6+1 function) into first byte of the work area (the number 
of characters to be transmitted). 


(5) Issue a PUT macro instruction. 


When the UNIVAC 9200/9300 program receives the data the 1001 has developed as 
a result of performing this search, the following steps are taken. 


(1) Set the function entry area to a receive-data function. 


(2) Store the number of characters to be received in the first byte of the work 
area. 


(3) Issue a GET macro instruction. 
The data will be received in byte 2 and the following bytes of the work area. 


Typically, the data received from the 1001 contains some status character (find/no- 
find, for example) and the data requested by the preceding send-data function. 
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The nature of any function or status characters embedded in data to be sent or 
received and the location of these characters in the data message is a user 
responsibility. The IOCS system makes no attempt to control the information 
content of data sent or received. . 


Input Area Entry (IOA1) 


This entry specifies the name of the input buffer area. In the UNIVAC 9200/9300 
Card System, it is used only for the reader file. The key word is IOA1. The speci- 
fication is the symbolic name of the input buffer area assigned to the device. This 
symbolic name must be the symbol used by the programmer in the DS statement de- 
fining the area in his main program. 


IOA1=CARD, 


The symbolic name assigned by this entry is never referenced directly by the pro- 
grammer. Images are delivered by the input/output routines into a specified work 
area. 


Input Area Entry (INAR) 


This entry is used to specify the symbolic name of the user-defined input buffer area 
when the read feature of the read/punch unit is required. The key word is INAR. The 
specification is the symbolic name of the area assigned to the read/punch unit as 
defined by the programmer. The operand for a read/punch buffer area labeled INPC 
has the following form. 


INAR=INPC, 


Input Translate Table Entry (ITBL) 


This entry specifies the symbolic name of a translate table located in the main pro- 
gram by which all records of a given input file are to be translated. 


The key word is ITBL and the specification is the symbolic name assigned by the 
programmer to the table. The operand for a translate table labeled CODE has the 
following form: 


ITBL=CODE, 


3.2.10. Mode Detail Entry (MODE) 


This entry is used to specify the mode of the input/output file and is required as 
part of the definition statement for all devices but the printer. The key word of the 
entry is MODE. The allowable specifications are: 


UP-4092 


3.2.11. 


UNIVAC 9200/9300 Apoendiz DB 


CARD ASSEMBLER SECTION: PAGE: 





OPERAND FORM REMARKS 





MODE=BINARY, For cards read and/or punched in column 
binary mode (160 byte I/O area required) 


MODE=-CC, For cards read and/or punched in compressed 
code (80 byte I/O area required) 


lation (Card Controller only) (80 byte I/O 
area required) 
MODE=TRANS, For cards to be read and/or punched trans- 
lated by the table specified by the ITBL or 
or OTBL entry 
MODE=TRANSTC, For Card Controller only, if translation of 
1001 code is required through the translation 


MODE=1001 For cards read in 1001 mode without trans- 
| 
| table specified by the ITBL entry 


There are two translation modes which may be defined with the 1001 Card Controller. 


mw TRANS, implies all cards read into the 9200 from the 1001 are translated from 
compressed code by the translate table specified by the ITBL detail entry card. 


gm TRANSTC, implies all cards read into the 9200 from the 1001 are translated from 
1001 code by the translate table specified by the ITBL detail entry card. This 
mode is used when combined reading (both primary and secondary in one function) 
is required, since basic 1001 memory capability is exceeded if two images are 
read in in other than 1001 code. 

ing in translated mode, card images a 

into the input area in compressed code, moved to the work area, and translated there. 

Thus, for example, when control is transferred to the user end-of-file address, the 

image of the end-of-file card is in the work area in translated mode, and the image 

of the card immediately following the end-of-file card is in the input area in com- 

pressed code. 


the online serial card 


ae au 


'z] 


ot 


9 


For the Card Controller operating in translated mode, card images are read into the 
work area in compressed code and are translated in the work area. 
Output Area Entry (OUAR) 


The entry specifies the symbolic name of the output buffer area as defined in the 
main program when the punch function of the punch, read/punch unit is required. 


The key word is OUAR. The specification is the symbolic name assigned by the 
programmer in the DS statement defining the area. The operand for an output area 
labeled OUPC has the following form: 


OUAR = OUPC, 
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There is no need to define an output buffer area for the printer, since IOCS uses 
the print buffer area in restricted memory. 


Output Translate Table (OTBL) 


The entry specifies the symbolic name of the translate table located in the main 
program through which all output images are to be translated. 


The key word is OTBL. The specification is the symbolic name assigned to the 
table. The operand for a translate table labeled CRDC has the following form: 


OTBL=CRDC, 


Overlap Entry (ORLP) 


This entry specifies that the read/punch unit file is to be processed in an overlap 
mode and applies only to the read/punch unit when used as both a reader and a 
punch. The entry is omitted when information is to be punched in a card which has 
been read previously. 


The key word of this entry is ORLP and the specification is YES. The operand has 
the following form: 


ORL P= yY ES; 


Print Bar Entry (FONT) 


The entry specifies the print bar the program expects to find in the user configura- 
tion. The key word is FONT and the allowable specifications are 48 or 63. The 
operand for a 63 character print bar has the following form: 


WwArawT _ «£29 
FUINI —OO,; 


Printer Advance Entry (PRAD) 


This entry is used in conjunction with printer files and enables the programmer to 
specify a standard advance of one or two lines. 


The key word is PRAD. The allowable specifications are 1 or 2. The operand for 
double spacing has the following form: 


PRAD =2, 


Punch Error Entry (PUNR) 


This entry specifies that automatic error recovery, where possible, is to be provided 
in the punch routine and applies only to that device. If it is not specified, all punch 
errors bring the computer to a stop. 


The key word is PUNR. The allowable specification is YES. The operand has the 
following form. 


PUNR=YES, 
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Printer Overflow Entry (PROV) 


This entry must be provided if the user wants any special action as a result of 
form overflow on the printer. If the printer overflow entry is not provided, printer 
spacing proceeds as directed by the printer advance detail entry and/or the CNTRL 
macro specifying skipping or spacing. 


The key word of the entry is PROV. The specification may be either YES or a label. 
The operand has the following form: 


PROV =YES 
or 
PROV = label 


If the specification is YES, an automatic skip to channel 7 (home paper) in the 
paper tape loop is provided in response to form overflow. 


If the specification is a label other than YES, control is transferred unconditionally 
to the specified label in response to form overflow. The label specified should be 
the symbolic name assigned to the user overflow routine provided to perform the 
desired form overflow action. 


The user indicates the point at which form overflow is to occur by a channel 1 punch 
in the paper tape loop. The form overflow punch (channel 1 punch) is recognized 

when spacing paper, either in response to a CNTRL macro specifying spacing before 
printing or in response to a PUT macro after printing a line. (The form overflow punch 
is not recognized during a printer skip operation.) 


Response to recognition of a form overflow punch may be illustrated by the following 
sequence of operations: 


(1) PUT FILA 
(or CNTRL FILA,SP,m,n m#0) 
- Process 
(2) PUT FILA 
(or CNTRL FILA,SP,m,n m #0) 
- Process 
(3) PUT FILA 
(or CNTRL FILA,SP,m,n m/#0) 
RET 


* Process 
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If the form overflow punch is recognized during the spacing associated with (1), 
then after (3) is executed, the form overflow action specified is taken. If the action 
is to transfer control to a user subroutine, then control goes to that subroutine 
rather than to the label RET. The address of the label RET is in general register 14 
when control is transferred to the form overflow subroutine. 


Type of File Entry (TYPF) 


This entry indicates whether the file is an input, output, or a combined file. It is 
applicable only to the 9200/9300 read/punch unit. 


The key word of the entry is TYPF. The allowable specifications are given below. 





OPERAND FIELD COMMENTS 
TYPF =INPUT, Reading only 
= OUTPUT, Punching only 


=COMBND, Reading and punching 
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4, SUMMARY OF DETAIL ENTRY CARDS 


OPERANDS FIELD APPLIES TO 





| ge] © laslest 

\ tk a 

KEY WORD ALLOWABLE z2| 2 zOd REMARKS 
SPECIFICATION wl & O° r 





CHNL 5 thru 12 Required for 1001 


BKSZ 96, 120 or 132 Le Required for online printer 




















| 
| | | | 
! CNTL [Yes X X | X  |Required if CNTRL macro is used 
| | ee | | 
EOFA Symbolic name of user Xx X x ‘Applies to input files only 
end of file routine | | | 
| | | | | 
| FUNC | Symbolic name of user | | X (Required by card controller 
defined 1-byte area where j | 
: function is stored | 
‘ | ' : i i 
i 10A1 i Symbolic name of user | xX | | | ‘lf binary image requested, 160 byte area | 
; ‘defined input buffer area required | 
: ; i | : 
| i i 
iNAR > Symbolic name of user i XX. Required if reading in the read/punch file 
, defined input buffer area ; : ? 
: i t i | i i 
; ' i i uy Poets at Fe. ee oe 
ITBL ; Symbolic name of user X ry & X Required if translation of input file desired 
‘defined input translate | 
; table | 






| | ' i 
| MODE |See Appendix B,3.2.10 | X | en oe 
: H i i i H 





| Required for punch files and read/punch files 
| | 7 Poot | 
f | ) 
OTBL :Symbolic name of user ; bo De oe st ‘Required if translation of output file desired 
‘defined output translate | 
i table i 
i 4 t : } i i | 
aa a aaa ACT OA a aa 
| ORLP ‘Yes i ae 
{ ' ; ' i i 
: 
| FONT | 48 or 63 Lee ‘Specifies 48 or 63 character print font | 






PROV Yes or symbolic name of | X ‘Required if form overflow action is to be taken | 
| 'user form overflow routine! | 














| | | 

i PRAD- ‘lor 2 i © KX 4 ‘Specifies standard print advance } 

' ' ‘ : ' ; 

a { / H i ‘ : , 4 

,  PUNR ° Yes xX | ‘Automatic error recovery desired | 

'  TYPF | Input 7 xX I ‘Reading only | 
Output . Punching only 


3 ‘ Combnd ! 5 oe ‘Reading & punching 
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5.1. Punch File Example Definition 


LABEL % OPERATION 8 OPERAND COMMENTS 
14 


5.2. Reader File Example Definition 


LABEL *® OPERATIONS OPERAND COMMENTS 
14 


LEE 
i 
| 


5.3, Printer File Example Definition 






Cc 
FON T=,48), i 
P 


eR OV = = 
078 4=,P,848,, 
$ Z,=,1,3)2 
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5.4. Read and Punch File Example 


LABEL +t OPERATIONS OPERAND COMMENTS 
4 


D, T, ; 
Ni T, =, YES), 

EOF A=. FIIN, 
i INAR=|READ,, » |i 
lite =C,T t 

MO) D, E =, T, RA t 

O, UA, R,=FUIN SC, 
07TBL,=MCT,C, 


T, YLP_F,=C, 0] MB,N,D 





_ 





; —_ 
OD 
co 
a] 
A 
Uv 
a 











5.5. Card Controller File Example 


LABEL %& OPERATIONS OPERAND COMMENTS 
8 14 


SiALss 4 fT ESE | | | 
ie CN TL= YES fez 
E 
a 


ij 








| feo.F A= END, 
Pita | 7.45800, 














6. I0CS MACRO INSTRUCTIONS (IMPERATIVE MACROS) 


This section describes the format, function, and use of the IOCS macro instructions 
used to communicate with the input/output routines and to control their operations. 
These symbolic instructions are used in the main program to provide the necessary 
linkages to the IOCS routines previously defined by means of the definition statements 
to the Preassembly Macro Pass. The handling of records into and out of I/O areas is 
performed by IOCS exclusively. Each file is processed in the manner dictated by the 
definition statement. 


Source programs using IOCS may not contain any Assembler I/O instructions. 


The format of the macro instruction follows the rules of the Assembler coding format. 
The macro verb is the operation, and the operand field may contain up to four para- 
meters as required by the particular macro. All macros may have a label. The impera- 
tive macro instructions are not handled by the Preassembly Macro Pass, but are 
processed by the Assembler itself. 


6.1. GET Macro Instruction 


The GET macro makes the next record available in the user-defined work area or 
transfers control to the end-of-file address entry upon recognizing an end-of-file card 
in an input file. 
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The GET macro has the following form 





OPERAND 






OPERATION 





filename,workarea 





where filename is the symbolic name defined in the label field of a DTF(XX) header 
entry card. 


workarea is the symbolic name of the user-defined storage area where the record 
is to be delivered. 


PUT Macro Instruction 


The PUT macro transfers a record from the work area for printing, punching, or sending 
to the 1001 and immediately frees the work area for main program use. 


The PUT macro has the following form 


OPERATION OPERAND 





PUT filename,workarea 


where filename is the symbolic name defined in the label field of a DT F(XX) header 
entry card. 


workarea is the symbolic name of the user-defined storage area where the record is 
made available for output. 


Work Area Considerations 


The imperative macro instructions, GET and PUT, require as a second parameter the 
symbolic name of a work area for transferring records from and to input/output buffer 
areas. Input/output areas (those assigned by IOA1, INAR, and OUAR detail entry 
cards) may not be used as work areas as they are used by IOCS to maintain standby 
reserve areas. 


The programmer must therefore provide, through the use of DS statements, work areas 
where records are processed. These work areas may be common to more than one file 
as efficiency demands, but must be as large as the largest record to be processed 
therein. 


Programming Considerations — Read/Punch Combined File 


When the Overlap detail entry card is used for a read/punch combined file, the follow- 
ing rule applies: 


A PUT macro instruction causes punching into the card which follows the one 
made available by the last GET macro instruction, because the card made avail- 
able by the last GET macro is already past the punch station when the PUT 
macro is given. 


When the Overlap detail entry card is omitted for a read/punch combined file, a PUT 
macro instruction causes punching into the card made available by the last GET macro 
instruction. 
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6.5. OPEN Macro Instruction 


This macro instruction initializes the file and must be issued before any other macro 
instruction pertaining to the same file. 


The OPEN macro has the following form: 


OPERATION OPERAND 





OPEN filename 


where filename is the symbolic name defined by the user in the label field of the 
DTF(XX) header entry card. 


An OPEN macro for a file may be executed at any time, even after the file has been 
opened by a previous OPEN macro. In such a case, the input/output routine is set 
back to an initial state. That is: 


1. For an input file, the card image delivered in response to the first GET executed 
after a second OPEN macro is the image immediately in front of the read station 
at the time the second OPEN mactrc is given. 


2. For an output file, the first item transmitted after the second OPEN macro is the 
item delivered by the first PUT executed after the reOPEN. 


OT OCR NAR an Tackteapes 
VLLVOL WaALCTU LSLIUCLION 


cn 
ch 


This macro instruction insures the proper closing of all files. The CLOSE macro has 
the following form: 


OPERATION OPERAND 





CLOSE filename 


where filename is the symbolic name defined in the label field of the DT F(XX) header 
entry card. 


6.7. CNTRL Macro Instruction 


The CNTRL macro is used by the programmer for printer spacing, printer skipping, 
stacker selection, numeric printing, and specifying the number of columns of card 
punching. 


6.7.1. Printer Spacing 


The CNTRL macro for printer spacing has the following form: 


OPERATIGN j GPERAND 





CNTRL filename,SP,m,n 
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where filename isthe symbolic name of the file defined in the label field of the 
DTFPR header entry card 


SP, specifies spacing 
m is the number of lines to space the form before printing (m =0, 1 or 2) 


n is the number of lines to space the form after printing (n = 0, 1 or 2) 


The programmer may omit m or n. If no CNTRL macro instruction specifying delayed 
spacing (m omitted) is given before the next PUT macro for the printer file, the 
printer advances the standard amount as specified in the PRAD detail entry card 

of the definition statement. 


If more than one CNTRL macro specifying paper movement after printing is given 
between PUT macros to the printer file, only the last CNTRL macro is effective. 


Printer Skipping 


The CNTRL macro for printer skipping has the following form: 


OPERATION OPERAND 





CNTRL filename,SK,m,n 


where filename is the symbolic name of the file defined in the label field of the 
DTFPR header entry card 


SK, specifies skipping 


m is the number of the tape channel the carriage is skipped to before printing 


Cinta TD 
n is the number of the tape channel the carriage is skipped to after printing 
Cn les?) 


The programmer may omit m or n. Between PUT macros, only the last CNTRL macro 
specifying skipping after printing is effective. 


Due to timing conditions, throughput is maintained at the best possible level if 
delayed spacing and skipping are used where possible. 


Stacker Select 


The CNTRL macro for selecting other than the normal stacker on the serial punch, 
read/punch, or for selecting any stacker on the card controller has the following 
form: 


OPERATION OPERAND 





CNTRL filename,SS,n 


where filename is the symbolic name of the file defined in the label field of the 
header entry card. 


SS, specifies stacker select 


n is the stacker number where the card is to be selected on the card controller 
only. Allowable values are specified in the following table. 
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PRIMARY 
Stacker 


Specification (n) 





NOTE: If this CNTRL macro is not given for the 1001, primary feeds are selected 
to Pl and secondary feeds to S1. 


The CNTRL macro for Card Controller stacker selection operates under the following 
tules. The card made available by a transfer-and-read from a particular feed is selected 
on the next transfer-and-read from that feed. The card made available by a transfer 

only from a particular feed is selected on the second following transfer-and-read from 
that feed. If the user issues a CNTRL macro after receiving a particular card image, the 
CNTRL macro governs the stacker selection for that particular card, regardless of the 
sequence of operations following that CNTRL macro. If no stacker is selected from a 
card in the manner described here, the card will be put in the normal stacker, which is 
P1 for the primary feed and S1 for the secondary feed. 


6.7.4. Numeric Printing 


The CNTRL macro instruction for numeric printing enables the programmer to maintain 
maximum printing speeds. Once set it remains set until and unless another numeric 
print CNTRL macro is given specifying that alphanumeric printing is requested. 


The CNTRL macro instruction for numeric printing has the following form: 


OPERATION OPERAND 





CNTRE filename ND.m 


4 fo ESS para gy 


where filename is the symbolicname of the file as defined in the label field of the 
DTFPR header entry card. 


NP, specifies a change in the mode of printing 
m is mode of printing requested 
m = 0, alphanumeric printing required 


m = 1, numeric printing required 
NOTE: Alphanumeric printing is assumed by IOCS if no CNTRL macro is given. 


6.7.5. Specifying Columns to be Punched 


The CNTRL macro instruction enables the programmer to vary or alter the number otf 
columns punched in the punch file. This function enables the punch to run at maximum 
speed for the particular application. Once set by the macro the nuniber of columns 
punched remains the same unless or until another such macro is given. If no CNTRL 
macro is given, IOCS assumes a full card is required. 
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The CNTRL macro for punching has the following form 


OPERATION OPERAND 





CNTRL filename, NC,n 


where filename is the symbolic name defined in the label field of the DTFRP 
header entry card 


NC, identifies a number-of-columns specification 


n is the number of columns to be punched (an even number 2,4,6...80). 


6.8. Summary of 9200/9300 Card System IOCS Imperative Macros 






DEVICE ADDRESSED 


fe ee! 

a 

2 aa OO SE 

pee Pesca fe 
| CNTRL | filename, SK, m,n 

Pare [ammare 

Ce on A OS AES 














OPTIONAL 





filename, SS, n 
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7. PROGRAMMING CONVENTIONS — PROGRAM REGISTERS 


A user routine may be required in the main source program that is accessed by IOCS 
when certain checking features are required (for example, printer overflow). IOCS 
automatically stores the program re-entry address in register 14 when the branch to 

the user routine occurs. The user routine is therefore required to provide the necessary 
return linkage to the main source program. If the user routine uses register 14, it must 
therefore, preserve and restore register 14 before terminating. This must also be done 

if any macro instruction is executed by the user routine, since all macros use program 
registers 14 and 15. If register 14 is not preserved, the re-entry address is lost. Register 
15 may also be used by the user routine and it need not be preserved. However, its con- 
tents are altered by the execution of any macro instruction. 


8. GENERAL PROCEDURE SUMMARY FOR USING IOCS 


The programmer defines his input/output control routines and their associated files 
through the use of definition statements presented to the Preassembly Macro Pass 
program. The generated I/O routines are then either assembled as part of the main 
source program or assembled separately and linked with the main program at load 

time. During the execution of the main program, input/output functions are accomplished 
through the imperative macro calls. 
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APPENDIX C. CARD LOAD ROUTINE 


GENERAL 


The Card Load Routine for the basic card reader and the 80-column 1001 Card Control 
consists of the following sections of coding: 


1. 


Bootstrap coding to read the Load Routine into memory. Before transferring control 
to the Load Routine, the bootstrap coding sets the EBCDIC mode and enters the 
processor state. 


Coding to clear a selected portion of memory to a selected character. This coding 
is executed before the Load Routine itself is read into memory. If the area specified 
to be cleared includes the Load Routine and its read area, they are not cleared. 


Coding to load a program in Assembler output format into the internal storage of 

of the UNIVAC 9200/9300. The Load Routine performs a hole count check of each 
card used. Upon encountering a Transfer Card (a card with Y in column 2) signifying 
termination of loading, the Loader compares the number of External Reference and 
Text Cards (type K or Q) read with the number contained in columns 12 and 13 of 
the Y card. If the numbers agree, the Load Routine loads register 13 with the ad- 
dress at which to begin program execution and transfers control to that address. 
This is the address contained in columns 15 and 16 of the Y card. If these columns 
are blank, the transfer address used is that contained in columns 15 and 16 of the 


program reference card (type J). 


If the card count check fails, the Load Routine halts. At this point pressing the 
Start switch causes the Load Routine to begin execution of the program just loaded. 
Before transferring control to the program just loaded, the Card Load Routine sets 
up the I/O PSC for EXEC I. 


PARAMETERS FOR THE LOAD ROUTINE 


The Load Routine is maintained as an object code deck ready to be linked. Certain 
labels exist as external references, defining these labels supplies the variable informa- 
tion required by the Load Routine. Standard definitions for these labels are given on 
EQU cards supplied with the Load Routine. 


NOTE: All labels used by the Load Routine begin with the characters ‘‘L?’’. 
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The external labels, their meaning, and standard definitions are shown below. 


LABEL MEANING STANDARD DEFINITION 
L?AR Start of the read area for the Load 80 
Routine. 


L?PG Start of the coding of the Load L?AR+80 
Routine. 


L?LO First memory location to be 80 
cleared. 


L?HI Last memory location to be 8191 
cleared. 


L?CH Character with which to fill the X‘A9’ (HPR instruction) 


area to be cleared. 





L?AM The value assigned determines 4 
whether alterations are to be 
stored in memory location 4 or the 
memory location specified in the 
address switches. If the value as- 
signed is four, alterations are 
stored in location 4; if zero, in the 
location specified by the memory 
address switches. 


As implied by the above table, the read area for the Load Routine does not have to be 
contiguous with the coding of the Load Routine. 


LOADING ADDITIONAL PROGRAMS 


If the Load Routine is in memory, it may be used to load another program by entering 
at the load routine’s initial location (represented by the tag L?PG). The program to 
be loaded must not overlay the Load Routine or its read area. 


A terminating program may also initiate the loading of a successor program if the suc- 
cessor contains a load routine of its own. The program must read the first card (boot- 
strap card) of the successor into a location in memory, set an address into register 
15, and transfer to another address. The address chosen for the bootstrap card must 
not overlap either the load routine of the successor program or the read area of the 
Load Routine. The bootstrap card must be read in in compressed code and must not 
be translated. This facility is possible only if the online card reader is being used 

to load programs. 
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4, LOAD ROUTINE STOPS 





DISPLAY MEANING ACTION 













4300 Card count error Press START to begin 
execution of program just 
loaded. 

6188 Reader malfunction or hole Refeed the error card. 

count error. For hole count Ready the reader and 
error SS is not significant, START. 


For reader errors SS is the 
status byte. 
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APPENDIX D. EXEC | 


GENERAL 


EXEC I is designed for UNIVAC 9200/9300 Card System only and takes the form of a 
relocatable element which must be included in the worker program at linker time. The 
primary functions of EXEC I are to monitor interrupts, handle messages to and from 
the operator, and provide restart communication. 


MACRO INSTRUCTIONS 


EXEC I provides the following macro instructions: 


MESSAGE MACRO (MSG) 


The message macro has the format given below. 


OPERATION OPERAND 





MSG Message, REPLY 


The REPLY parameter is optional. Message may be any acceptable two-byte hexadeci- 
mal expression. 


This macro generates the following code: 





OPERATION OPERAND 
SRC 0,8 
DC Y(message) 
DC CL1‘x’ 
DC X‘0’ 


Where message is the two-byte hexadecimal dispiay which appears in the HPR instruc- 
tion. It takes the form of an assembler language expression. 


x = A, if the parameter REPLY appears; x = a blank (EBCDIC code 01000000), 
if it does not. 


The one-byte reply, keyed-in by the operator into location 4, appears in the last 
byte of the calling sequence. 
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EXEC I responds to this macro by doing a BAL, using register 15, to its own display 
subroutine. This moves the message from the calling sequence of the SRC instruction 
to the calling sequence of the BAL instruction before executing the BAL instruction. 
The display subroutine sets location 4 to binary zero and displays the message via 

an HPR instruction. When the Start switch is depressed, the display subroutine returns 
control via register 15. EXEC I then moves the contents of location 4 to the reply 
byte of the calling sequence and returns control to the worker program. 


For example, if the user codes the following macro instruction, 


DSPL MSG X‘FFF’, REPLY 


the Assembler treats this macro instruction the same asthe following source code. 


DSPL SRC 0,8 
DC Y(X‘FFF’) 
DC CLI1‘A’ 
DC X‘0’ 


When the object code produced from this source code is executed, the computer stops 
with a display of 000111111111111. The operator may then answer this display via 
the Data Entry and Alter switches. When the Start switch is subsequently depressed, 
control is returned to the user’s coding at the instruction located at DSPL+8. The 
byte inserted into the computer by the operator via the Data Entry and Alter switches 
is in location DSPL+ 7. If the operator did not introduce any data via the Data Entry 
and Alter switches, then on return of control to the user program, the byte in location 
DSPL+7 contains binary zeros. 


The MSG macro instruction is not handled by the Preassembly Macro Pass, but is 
processed by the Assembler itself. 


RESTART MACRO 


The restart macro has the following format 


OPERATION OPERAND 





RSTRT Restart-Name 


The restart-name is the label of a user-coded rcutine which is designed to handle a 
restart operation. 


This macro generates the following code: 


OPERATION OPERAND 





SRC 0,0 


DC Y(Restart-name) 
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Appendix D 


SECTION: 


In response to this macro instruction, EXEC I stores the address of the restart-name. 
Restart is accomplished by a general clear followed by depression of the Start switch. 
This causes the instruction in memory locations 22 through 25 to be executed in I/O 
mode. EXEC I has a branch unconditional instruction in this location that allows it 

to set the processor PSC to the restart-name and then go to RE-ENTRY. At RE-ENTRY, 
EXEC I sets the device address byte to zero, resets (without destroying the SRC field) 
the I/O PSC in preparation for the next interrupt, and returns to processor state. 


At the restart-name location the user must provide a restart routine. This routine must 
re-establish variable information in the program and set initial conditions for all input/ 
output routines. (To aid the user in accomplishing this goal, the execution of the OPEN 
macro resets the initial conditions for all IOCS routines.) The user must establish 
conventions to reposition card decks and printer paper. 


The RSTRT macro instruction is not handled by the Preassembly Macro Pass, but is 
processed by the Assembler itself. 


3. 1/0 CONTROL ROUTINE MESSAGES 


All IOCS routines operating in I/O mode may display messages through direct access 
to the display subroutine. After execution, if a reply is expected, the control routine 
itself must examine the contents of location 4. 


The following instructions are required to execute a display: 





OPERATION OPERAND 
BAL 15,E?DS 
DC XL2‘message’ 


where E?DS is the label for the first byte of the display routine. 


Message is a two-byte hexadecimal expression. 
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